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(57) Abstract: The present invention discloses a modified computer architecture (50, 71, 72) which enables an applications pro- 
gram (50) to be run simultaneously on a plurality of computers (Ml, .... Mn). Shared memory at each computer is updated with 
amendments and/or overwrites so that all memory read requests are satisfied locally. During initial program loading (75), or similar, 
Q instructions which result in memory being re- written or manipulated are identified (92). Additional instructions are inserted (103) 
to cause the equivalent memory locations at all computers to be updated. In particular, the finalization of JAVA language classes and 
objects is disclosed (162, 163) so finalization only occurs when the last class or object present on all machines is no longer required. 



WO 2005/103927 PCT/AU2005/000581 
MODIFIED COMPUTER ARCHITECTURE WITH FINALIZATION OF OBJECTS 



Field of the Invention 

The present invention relates to computers and, in particular, to a modified 
machine architecture which enables the operation of an application program 
5 simultaneously on a plurality of computers interconnected via a communications 
network. 

Background Art 

Ever since the advent of computers, and computing, software for computers 
has been written to be operated upon a single machine. As indicated in Fig. 1, that 
1 0 single prior art machine 1 is made up from a central processing unit, or CPU, 2 which 
is connected to a memory 3 via a bus 4. Also connected to the bus 4 are various other 
functional units of the single machine 1 such as a screen 5, keyboard 6 and mouse 7. 

A fundamental limit to the performance of the machine 1 is that the data to be 
manipulated by the CPU 2, and the results of those manipulations, must be moved by 
15 the bus 4. The bus 4 suffers from a number of problems including so called bus 

"queues" formed by units wishing to gain an access to the bus, contention problems, 
and the like. These problems can, to some extent, be alleviated by various stratagems 
including cache memory, however, such stratagems invariably increase the 
administrative overhead of the machine 1. 

20 Naturally, over the years various attempts have been made to increase machine 

performance. One approach is to use symmetric multiple processors. This prior art 
approach has been used in so called "super" computers and is schematically indicated 
in Fig. 2. Here a plurality of CPU's 12 are connected to global memory 13. Again, a 
bottleneck arises in the communications between the CPU's 12 and the memory 13. 

25 This process has been termed "Single System Image". There is only one application 
and one whole copy of the memory for the application which is distributed over the 
global memory. The single application can read from and write to, (ie share) any 
memory location completely transparently. 

Where there are a number of such machines interconnected via a network, this 
30 is achieved by taking the single application written for a single machine and 
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partitioning the required memory resources into parts. These parts are then distributed 
across a number of computers to form the global memory 13 accessible by all CPU's 
12. This procedure relies on masking, or hiding, the memory partition from the single 
running application program. The performance degrades when one CPU on one 
5 machine must access (via a network) a memory location physically located in a 
different machine. 

Although super computers have been technically successful in achieving high 
computational rates, they are not commercially successful in that their inherent 
complexity makes them extremely expensive not only to manufacture but to 
1 0 administer. In particular, the single system image concept has never been able to 
scale over "commodity" (or mass produced) computers and networks. In particular, 
the Single System Image concept has only found practical application on very fast 
(and hence very expensive) computers interconnected by very fast (and similarly 
expensive) networks. 

15 A further possibility of increased computer power through the use of a plural 

number of machines arises from the prior art concept of distributed computing which 
is schematically illustrated in Fig. 3. In this known arrangement, a single application 
program (Ap) is partitioned by its author (or another programmer who has become 
familiar with the application program) into various discrete tasks so as to run upon, 

20 say, three machines in which case n in Fig. 3 is the integer 3. The intention here is 
that each of the machines Ml . . .M3 runs a different third of the entire application and 
the intention is that the loads applied to the various machines be approximately equal. 
The machines communicate via a network 14 which can be provided in various forms 
such as a communications link, the internet, intranets, local area networks, and the 

25 like. Typically the speed of operation of such networks 14 is an order of magnitude 
slower than the speed of operation of the bus 4 in each of the individual machines Ml, 
M2, etc. 

Distributed computing suffers from a number of disadvantages. Firstly, it is a 
difficult job to partition the application and this must be done manually. Secondly, 
30 communicating data, partial results, results and the like over the network 14 is an 
administrative overhead. Thirdly, the need for partitioning makes it extremely 
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difficult to scale upwardly by utilising more machines since the application having 
been partitioned into, say three, does not run well upon four machines. Fourthly, in 
the event that one of the machines should become disabled, the overall performance 
of the entire system is substantially degraded. 

5 A further prior art arrangement is known as network computing via "clusters" 

as is schematically illustrated in Fig. 4. In this approach, the entire application is 
loaded onto each of the machines Ml , M2 . . . .Mn. Each machine communicates with 
a common database but does not communicate directly with the other machines. 
Although each machine runs the same application, each machine is doing a different 
10 "job" and uses only its own memory. This is somewhat analogous to a number of 
windows each of which sell train tickets to the public. This approach does operate, is 
scalable and mainly suffers from the disadvantage that it is difficult to administer the 
network. 

In computer languages such as JAVA and MICROSOFT.NET there are two 
15 major types of constructs with which programmers deal. In the JAVA language these 
are known as objects and classes. Every time an object is created there is an 
initialization routine run known as "<init>". Similarly, every time a class is loaded 
. there is an initialization routine known as "<clinit>". Other languages use different 
terms but utilize a similar concept. However, there is no equivalent "clean up" or 
20 deletion routine to delete an object or class once it is no longer required. Instead, this 
"clean up" happens unobtrusively in a background mode. 



The present invention discloses a computing environment in which an 
application program operates simultaneously on a plurality of computers. In such an 
25 environment it is necessary to ensure that the "clean up" (or deletion or finalisation) 
operates in a consistent fashion across all the machines. It is this goal of consistent 
finalization that is the genesis of the present invention. 

In accordance with a first aspect of the present invention there is disclosed a 
30 method multiple computer system having at least one application program running 
simultaneously on a plurality of computers interconnected by a communications 
network, wherein a like plurality of substantially identical objects are created, each in 
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the corresponding computer and each having a substantially identical name, and 
wherein all said identical objects are collectively deleted when each one of said 
plurality of computers no longer needs to refer to their corresponding object. 

5 In accordance with a second aspect of the present invention there is disclosed a 

plurality of computers interconnected via a communications link and operating at least 
one application program simultaneously wherein each said computer in operating said 
at least one application program needs, or no longer needs to refer to an object only in 
local memory physically located in each said computer, the contents of the local 
10 memory utilized by each said computer is fundamentally similar but not, at each 
instant, identical, and every one of said computers has a finalization routine which 
deletes a non-referenced object only if each one of said plurality of computers no 
longer needs to refer to their corresponding object. 

In accordance with a third aspect of the present invention there is disclosed a 
method of running at least one application program on a plurality of computers 
simultaneously, said computers being interconnected by means of a communications 
network, said method comprising the steps of: 

(i) creating a like plurality of substantially identical objects each in the 
corresponding computer and each having a substantially identical name, and 

(ii) deleting all said identical objects collectively when all of said plurality of 
computers no longer need to refer to their corresponding object. 

In accordance with a fourth aspect of the present invention there is disclosed a 
method of ensuring consistent finalization of an application program to be run 
25 simultaneously on a plurality of computers interconnected via a communications 
network, said method comprising the steps of: 

(i) scrutinizing said application program at, or prior to, or after loading to detect 
each program step defining an finalization routine, and 

(ii) modifying said finalization routine to ensure collective deletion of 

30 corresponding objects in all said computers only when each one of said computers no 
longer needs to refer to their corresponding object. 
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In accordance with a fifth aspect of the present invention there is disclosed a 
method a multiple thread processing computer operation in which individual threads 
of a single application program are simultaneously being processed each on a 
corresponding one of a plurality of computers interconnected via a communications 
link, and in which objects in local memory physically associated with the computer 
processing each thread have corresponding objects in the local memory of each other 
said computer, the improvement comprising collectively deleting all said 
corresponding objects when each one of said plurality of computers no longer needs 
to refer to their corresponding object. 

In accordance with a sixth aspect of the present invention there is disclosed a 
computer program product comprising a set of program instructions stored in a 
storage medium and operable to permit a plurality of computers to carry out the 
abovementioned methods. 



Brief Description of the Drawings 

Embodiments of the present invention will now be described with reference to 
the drawings in which: 

Fig. 1 is a schematic view of the internal architecture of a conventional 
20 computer, 

Fig. 2 is a schematic illustration showing the internal architecture of known 
symmetric multiple processors, 

Fig. 3 is a schematic representation of prior art distributed computing, 
Fig. 4 is a schematic representation of a prior art network computing using 
25 clusters, 

Fig. 5 is a schematic block diagram of a plurality of machines operating the 
same application program in accordance with a first embodiment of the present 
invention, 

Fig. 6 is a schematic illustration of a prior art computer arranged to operate 
30 JAVA code and thereby constitute a JAVA virtual machine, 

Fig. 7 is a drawing similar to Fig. 6 but illustrating the initial loading of code 
in accordance with the preferred embodiment, 
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Fig. 8 is a drawing similar to Fig. 5 but illustrating the interconnection of a 
plurality of computers each operating JAVA code in the manner illustrated in Fig. 7, 

Fig. 9 is a flow chart of the procedure followed during loading of the same 
application on each machine in the network, 
5 Fig. 10 is a flow chart showing a modified procedure similar to that of Fig. 9, 

Fig. 1 1 is a schematic representation of multiple thread processing carried out 
on the machines of Fig. 8 utilizing a first embodiment of memory updating, 

Fig. 12 is a schematic representation similar to Fig. 1 1 but illustrating an 
alternative embodiment, 
10 Fig. 13 illustrates multi-thread memory updating for the computers of Fig. 8, 

Fig. 14 is a schematic illustration of a prior art computer arranged to operate in 
JAVA code and thereby constitute a JAVA virtual machine, 

Fig. 15 is a schematic representation of n machines running the application 
program and serviced by an additional server machine X, 
15 Fig. 16 is a flow chart of illustrating the modification of "clean up" or 

finalization routines, 

Fig. 17 is a flow chart illustrating the continuation or abortion of finalization 
routines, 

Fig. 18 is a flow chart illustrating the enquiry sent to the server machine X, 
20 Fig. 19 is a flow chart of the response of the server machine X to the request 

of Fig. 18, 

Fig. 20 is a schematic representation of two laptop computers interconnected 
to simultaneously run a plurality of applications, with both applications running on a 
single computer, 

25 Fig. 21 is a view similar to Fig. 20 but showing the Fig. 20 apparatus with one 

application operating on each computer, and 

Fig. 22 is a view similar to Figs. 20 and 21 but showing the Fig. 20 apparatus 
with both applications operating simultaneously on both computers. 

The specification includes Annexures A and C which provide actual code 
30 fragments which implement various aspects of the described embodiments. Annexure 
A relates to fields and Annexure C to finalization. 

Detailed Description 
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In connection with Fig. 5, in accordance with a preferred embodiment of the 
present invention a single application program 50 can be operated simultaneously on a 
number of machines Ml, M2. . .Mn communicating via network 53. As it will become 
apparent hereafter, each of the machines Ml, M2. . .Mn operates with the same 
5 application program 50 on each machine Ml, M2. . .Mn and thus all of the machines 
Ml, M2. . .Mn have the same application code and data 50. Similarly, each of the 
machines Ml, M2. . .Mn operates with the same (or substantially the same) modifier 
5 1 on each machine Ml , M2. . .Mn and thus all of the machines Ml, M2. . .Mn have 
the same (or substantially the same) modifier 51 with the modifier of machine M2 
1 0 being designated 51/2, In addition, during the loading of, or preceding the execution 
of, the application 50 on each machine Ml, M2. ..Mn, each application 50 has been 
modified by the corresponding modifier 51 according to the same rules (or 
substantially the same rules since minor optimising changes are permitted within each 
modifier 51/1 ...51/n). 

15 As a consequence of the above described arrangement, if each of the machines 

Ml , M2. . .Mn has, say, a shared memory capability of 10MB, then the total shared 
memory available to each application 50 is not, as one might expect, lOn MB but 
rather only 10MB. However, how this results in improved operation will become 
apparent hereafter. Naturally, each machine Ml, M2. . .Mn has an unshared memory 

20 capability. The unshared memory capability of the machines Ml, M2. . .Mn are 
normally approximately equal but need not be. 

It is known from the prior art to operate a machine (produced by one of 
various manufacturers and having an operating system operating in one of various 
different languages) in a particular language of the application, by creating a virtual 

25 machine as schematically illustrated in Fig. 6. The prior art arrangement of Fig. 6 
takes the form of the application 50 written in the Java language and executing within 
a Java Virtual Machine 6 1 . Thus, where the intended language of the application is 
the language JAVA, a JAVA virtual machine is created which is able to operate code 
in JAVA irrespective of the machine manufacturer and internal details of the machine. 

30 For further details see "The JAVA Virtual Machine Specification" 2 nd Edition by T. 
Lindholm & F. Yellin of Sun Microsystems Inc. of the USA. 
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This well known prior art arrangement of Fig. 6 is modified in accordance 
with the preferred embodiment of the present invention by the provision of an 
additional facility which is conveniently termed "distributed run time" or DRT 71 as 
seen in Fig, 7. In Fig. 7, the application 50 is loaded onto the Java Virtual Machine 
5 72 via the distributed runtime system 71 through the loading procedure indicated by 
arrow 75. A distributed run time system is available from the Open Software 
Foundation under the name of Distributed Computing Environment (DCE). In 
particular, the distributed runtime 71 comes into operation during the loading 
procedure indicated by arrow 75 of the JAVA application 50 so as to initially create 
10 the JAVA virtual machine 72. The sequence of operations during loading will be 
described hereafter in relation to Fig. 9. 

Fig. 8 shows in modified form the arrangement of Fig, 5 utilising JAVA 
virtual machines, each as illustrated in Fig. 7. It will be apparent that again the same 
application 50 is loaded onto each machine Ml, M2. . .Mn. However, the 
1 5 communications between each machine M 1 , M2 . . .Mn, and indicated by arrows 83, 
although physically routed through the machine hardware, are controlled by the 
individual DRT's 71/1 . . .71/n within each machine. Thus, in practice this may be 
conceptionalised as the DRT's 71/1 . . .71/n communicating with each other via the 
network 73 rather than the machines Ml, M2. . .Mn themselves. 

20 Turning now to Figs. 7 and 9, during the loading procedure 75, the program 50 

being loaded to create each JAVA virtual machine 72 is modified. This modification 
commences at 90 in Fig. 9 and involves the initial step 91 of detecting all memory 
locations (termed fields in JAVA - but equivalent terms are used in other languages) 
in the application 50 being loaded. Such memory locations need to be identified for 

25 subsequent processing at steps 92 and 93. The DRT 71 during the loading procedure 
75 creates a list of all the memory locations thus identified, the JAVA fields being 
listed by object and class. Both volatile and synchronous fields are listed. 

The next phase (designated 92 in Fig. 9) of the modification procedure is to 
search through the executable application code in order to locate every processing 
30 activity that manipulates or changes field values corresponding to the list generated at 
step 91 and thus writes to fields so the value at the corresponding memory location is 
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changed. When such an operation (typically putstatic or putfield in the JAVA 
language) is detected which changes the field value, then an '"updating propagation 
routine" is inserted by step 93 at this place in the program to ensure that all other 
machines are notified that the value of the field has changed Thereafter, the loading 
5 procedure continues in a normal way as indicated by step 94 in Fig. 9. 

An alternative form of initial modification during loading is illustrated in 
Fig. 10. Here the start and listing steps 90 and 91 and the searching step 92 are the 
same as in Fig. 9. However, rather than insert the "updating propagation routine" as 
in step 93 in which the processing thread carries out the updating, instead an "alert 
1 0 routine" is inserted at step 1 03. The "alert routine" instructs a thread or threads not 
used in processing and allocated to the DRT, to carry out the necessary propagation. 
This step 103 is a quicker alternative which results in lower overhead. 

Once this initial modification during the loading procedure has taken place, 
then either one of the multiple thread processing operations illustrated in Figs. 1 1 and 

15 12 takes place. As seen in Fig. 1 1, multiple thread processing 1 10 on the machines 
consisting of threads 1 1 1/1 ... 1 1 1/4 is occurring and the processing of the second 
thread 1 1 1/2 (in this example) results in that thread 1 1 1/2 becoming aware at step 1 13 
of a change of field value. At this stage the normal processing of that thread 1 1 1/2 is 
halted at step 114, and the same thread 111/2 notifies all other machines M2. . .Mn via 

20 the network 53 of the identity of the changed field and the changed value which 

occurred at step 113. At the end of that communication procedure, the thread 111/2 
then resumes the processing at step 115 until the next instance where there is a change 
of field value. 

In the alternative arrangement illustrated in Fig. 12, once a thread 121/2 has 
25 become aware of a change of field value at step 1 1 3, it instructs DRT processing 120 
(as indicated by step 125 and arrow 127) that another thread(s) 121/1 allocated to the 
DRT processing 120 is to propagate in accordance with step 128 via the network 53 to 
all other machines M2. . .Mn the identity of the changed field and the changed value 
detected at step 113. This is an operation which can be carried out quickly and thus 
30 the processing of the initial thread 1 1 1/2 is only interrupted momentarily as indicated 
in step 125 before the thread 1 1 1/2 resumes processing in step 115. The other thread 
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121/1 which has been notified of the change (as indicated by arrow 127) then 
communicates that change as indicated in step 128 via the network 53 to each of the 
other machines M2.. .Mn. 

This second arrangement of Fig. 12 makes better utilisation of the processing 
5 power of the various threads 1 1 1/1 ... 1 1 1/3 and 121/1 (which are not, in general, 
subject to equal demands) and gives better scaling with increasing size of "n", (n 
being an integer greater than or equal to 2 which represents the total number of 
machines which are connected to the network 53 and which run the application 
program 50 simultaneously). Irrespective of which arrangement is used, the changed 
1 0 field and identities and values detected at step 1 13 are propagated to all the other 
machines M2. . .Mn on the network. 

This is illustrated in Fig. 13 where the DRT 71/1 and its thread 121/1 of Fig. 
12 (represented by step 128 in Fig. 13) sends via the network 53 the identity and 
changed value of the listed memory location generated at step 113 of Fig. 12 by 
1 5 processing in machine M 1 , to each of the other machines M2 . . . Mn. 

Each of the other machines M2. . .Mn carries out the action indicated by steps 
135 and 136 in Fig. 13 for machine Mn by receiving the identity and value pair from 
the network 53 and writing the new value into the local corresponding memory 
location. 

20 In the prior art. arrangement in Fig. 3 utilising distributed software, memory 

accesses from one machine's software to memory physically located on another 
machine are permitted by the network interconnecting the machines. However, such 
memory accesses can result in delays in processing of the order of 10 6 - 10 7 cycles of 
the central processing unit of the machine. This in large part accounts for the 

25 diminished performance of the multiple interconnected machines. 

However, in the present arrangement as described above in connection with 
Fig. 8, it will be appreciated that all reading of data is satisfied locally because the 
current value of all fields is stored on the machine carrying out the processing which 
generates the demand to read memory. Such local processing can be satisfied within 
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10 2 - 10 3 cycles of the central processing unit Thus, in practice, there is 
substantially no waiting for memory accesses which involves reads. 

However, most application software reads memory frequently but writes to 
memory relatively infrequently. As a consequence, the rate at which memory is being 
5 written or re-written is relatively slow compared to the rate at which memory is being 
read. Because of this slow demand for writing or re-writing of memory, the fields can 
be continually updated at a relatively low speed via the inexpensive commodity 
network 53, yet this low speed is sufficient to meet the application program's demand 
for writing to memory. The result is that the performance of the Fig. 8 arrangement is 
1 0 vastly superior to that of Fig. 3 . 

In a further modification in relation to the above, the identities and values of 
changed fields can be grouped into batches so as to further reduce the demands on the 
communication speed of the network 53 interconnecting the various machines. 

It will also be apparent to those skilled in the art that in a table created by each 
1 5 DRT 71 when initially recording the fields, for each field there is a name or identity 
which is common throughout the network and which the network recognises. 
However, in the individual machines the memory location corresponding to a given 
named field will vary over time since each machine will progressively store changed 
field values at different locations according to its own internal processes. Thus the 
20 table in each of the DRTs will have, in general, different memory locations but each 
global "field name" will have the same "field value" stored in the different memory 
locations. 

It will also be apparent to those skilled in the art that the abovementioned 
modification of the application program during loading can be accomplished in up to 
25 five ways by: 

(i) re-compilation at loading, 

(ii) by a pre-compilation procedure prior to loading, 

(iii) compilation prior to loading, 

(iv) a "just-in-time" compilation, or 

30 (v) re-compilation after loading (but, or for example, before execution of the 
relevant or corresponding application code in a distributed environment). 
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Traditionally the term "compilation" implies a change in code or language, eg 
from source to object code or one language to another. Clearly the use of the term 
"compilation" (and its grammatical equivalents) in the present specification is not so 
restricted and can also include or embrace modifications within the same code or 
5 language. 

In the first embodiment, a particular machine, say machine M2, loads the 
application code on itself, modifies it, and then loads each of the other machines Ml, 
M3 ... Mn (either sequentially or simultaneously) with the modified code. In this 
arrangement, which may be termed "master/slave", each of machines Ml, M3, ... Mn 
1 0 loads what it is given by machine M2. 

In a still further embodiment, each machine receives the application code, but 
modifies it and loads the modified code on that machine. This enables the 
modification carried out by each machine to be slightly different being optimized 
15 based upon its architecture and operating system, yet still coherent with all other 
similar modifications. 

In a further arrangement, a particular machine, say Ml, loads the unmodified 
code and all other machines M2, M3 ... Mn do a modification to delete the original 
20 application code and load the modified version. 

In all instances, the supply can be branched (ie M2 supplies each of Ml, M3, 
M4, etc directly) or cascaded or sequential (ie M2 applies Ml which then supplies M3 
which then supplies M4, and so on). 

25 

In a still further arrangement, the machines Ml to Mn, can send all load 
requests to an additional machine (not illustrated) which is not running the application 
program, which performs the modification via any of the aforementioned methods, 
and returns the modified routine to each of the machines Ml to Mn which then load 
30 the modified routine locally. In this arrangement, machines Ml to Mn forward all 
load requests to this additional machine which returns a modified routine to each 
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machine. The modifications performed by this additional machine can include any of 
the modifications covered under the scope of the present invention. 

Persons skilled in the computing arts will be aware of at least four techniques 
5 used in creating modifications in computer code. The first is to make the modification 
in the original (source) language. The second is to convert the original code (in say 
JAVA) into an intermediate representation (or intermediate language). Once this 
conversion takes place the modification is made and then the conversion is reversed. 
This gives the desired result of modified JAVA code. 

10 

The third possibility is to convert to machine code (either directly or via the 
abovementioned intermediate language). Then the machine code is modified before 
being loaded and executed. The fourth possibility is to convert the original code to an 
intermediate representation, which is then modified and subsequently converted into 
15 machine code. 

The present invention encompasses all four modification routes and also a 
combination of two, three or even all four, of such routes. 

Turning now to Fig. 14, there is illustrated a schematic representation of a 
20 single prior art computer operated as a JAVA virtual machine. In this way, a machine 
(produced by any one of various manufacturers and having an operating system 
operating in any one of various different languages) can operate in the particular 
language of the application program 50, in this instance the JAVA language. That is, 
a JAVA virtual machine 72 is able to operate code 50 in the JAVA language, and 
25 utilize the JAVA architecture irrespective of the machine manufacturer and the 
internal details of the machine. 

In the JAVA language, the initialization routine <clinit> happens only once 
when a given class file 50A is loaded. However, the initialization routine <init> 
30 happens often, for example every time a new object 50X, 50Y or 50Z is created. In 
addition, classes are loaded prior to objects so that in the application program 
illustrated in Fig. 14, having a single class 50A and three objects 50X-50Z, the first 
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class 50A is loaded first, then first object SOX is loaded, then second object SOY is 
loaded and finally third object 502 is loaded. Where, as in Fig. 14, there is only a 
single computer or machine 72, then no conflict or inconsistency arises in the running 
of the initialization routines intended to operate during the loading procedure because 
5 for conventional operation each initialization routine is executed only once. 

Furthermore, the single machine of Fig. 14 is able to easily keep track of 
whether the specific objects 50X-50Z are, in future, liable to be required for the 
program 50. This is done by maintaining a "handle count" or similar. This count 
10 keeps track of the number of places in the executable code where reference is made to 
a specific object. When the handle count for a specific object reaches zero, there is 
nowhere in the executable code which makes reference to the object. The object is 
then said to be "finalizable". 

15 Once this state has been achieved, the object can be safely deleted (or cleaned 

up or finalized) because it is no longer needed. The same procedure applies mutatis 
mutandis for classes. In particular, the computer programmer when writing a program 
using the JAVA language and architecture, need not write any specific code in order 
to provide for this cleaning up, deletion or finalization. Instead a single JAVA virtual 

20 machine 72 can keep track of the class and object handle counts and clean up (or carry 
out finalization) as necessary in an unobtrusive fashion. 

However, in the arrangement illustrated in Fig. 8, (and also in Figs. 20-22), a 
plurality of individual computers or machines Ml, M2 Mn are provided each of 

25 which are interconnected via a communications network 53 and each of which is 
provided with a modifier 51 (as in Fig. 5 and realised by the DRT 71 of Fig. 8) and 
loaded with a common application program 50. Essentially the modifier 51 or DRT 
71 modifies the application code 50 to execute clean up routines across the plurality 
of individual machines Ml, M2...Mn. It follows therefore that in such a computing 

30 environment it is necessary to ensure that each of the individual machines is finalized 
in a consistent fashion (with respect to the others). 
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In particular, whilst one particular machine (say, M3) may have no further call 
on an object or class, another machine (say M5) may still need to refer to that object 
or class in future. Thus if the object or class were to be deleted from machine M3, 
then if M5 were to write to that object and amend its value, then that change in value 
5 could not be propagated throughout all the machines Ml, M2. . .Mn since the machine 
M3 would not include the relevant object in its local memory. Furthermore, were 
machine M3 to execute the cleanup routine on a given object or class, the cleanup 
routine would preform cleanup not just for that object on that machine, but all peer- 
objects on all other machines as well. Thus invalidating the object on machine M5. 

10 Thus the goal of substantially identical memory contents for each of the machines 
Ml, M2...Mn, as required for simultaneous operation of the same application 
program, would not be achieved. 

In order to ensure consistent finalization, or clean up, the application program 
50 is scrutinized in order to detect program steps which define a clean up routine. 

15 This scrutiny can take place either prior to loading, or during the loading procedure, 
or even after the loading procedure (but before execution of the relevant 
corresponding portion of the application code 50). It may be likened to a compilation 
procedure with the understanding that the term compilation normally involves a 
change in code or language, eg from source to object code or one language to another. 

20 However, in the present instance the term "compilation" (and its grammatical 
equivalents) is not so restricted and can also include embrace modifications within the 
same code or language. 

As a consequence, in the abovementioned scrutiny clean up routines are 
25 initially looked for, and when found a modifying code is inserted so as to give rise to 
a modified clean up routine. This modified routine is to abort the clean up routine on 
any specific machine unless the class or object to be deleted is marked for deletion by 
all other machines. There are several different modes whereby this modification and 
loading can be carried out. 

30 

Thus, in one mode, the DRT 71/1 on the loading machine, in this example 
JVM#1, asks the DRT's 71/2.. .71/n of all the other machines M2...Mn if the first 
object SOX, say, is utilized (ie not marked for deletion) by any other machine 
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M2. . .Mn. If the answer to this question is yes, then the normal clean up procedure is 
turned off or disabled for the first object SOX on machine JVM#1 . If the answer is no, 
(ie the first object 50X is marked for deletion on all other machines) then the normal 
clean up procedure is operated and the first object SOX is deleted not only on machine 
5 JVM#1 but on all other machines M2. ..Mn. Preferably the clean up task is allocated 
to the last machine Ml marking the object or class for deletion. 

As seen in Fig. 15 a modification to the general arrangement of Fig. 8 is 
provided in that machines Ml, M2. . .Mn are as before and run the same application 

1 0 program 50 (or programmes) on all machines Ml, M2. . .Mn simultaneously. 

However, the previous arrangement is modified by the provision of a server machine 
X which is conveniently able to supply housekeeping functions, for example, and 
especially the clean up of structures, assets and resources. Such a server machine X 
can be a low value commodity computer such as a PC since its computational load is 

15 low. As indicated by broken lines in Fig. 15, two server machines X and X+l can be 
provided for redundancy purposes to increase the overall reliability of the system. 
Where two such server machines X and X+l are provided, they are preferably 
operated as dual machines in a cluster. 

It is not necessary to provide a server machine X as its computational load can 
20 be distributed over machines Ml , M2 . . .Mn. Alternatively, a database operated by 
one machine (in a master/slave type operation) can be used for the housekeeping 
function(s). 

Fig, 16 shows a preferred general procedure to be followed. After loading 161 
has been commenced, the instructions to be executed are considered in sequence and 
25 all clean up routines are detected as indicated in step 1 62. In the JAVA language 

these are the "finalize( )" routine (or method in JAVA terminology). Other languages 
use different terms. 

Where a clean up routine is detected, it is modified at step 163, typically by 
inserting further instructions into the routine. Alternatively, the modifying 
30 instructions could be inserted prior to the routine. Once the modification has been 
completed the loading procedure continues, as indicated in step 164. 

16 
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Fig. 17 illustrates a particular form of modification. Firstly, the structures, 
assets or resources (in JAVA termed classes or objects) 50A, 50X...50Y which are 
possible candidates to be cleaned up, have already been allocated a name or tag which 
can be used globally by all machines Ml, M2. . .Mn, as indicated by step 172. This 

5 preferably happens when the classes or objects are originally initialized. This is most 
conveniently done via a table maintained by server machine X. This table also 
includes the "clean up status" of the class or object. In the preferred embodiment, this 
table also includes a counter which stores a count of the number of machines which 
have marked this asset for deletion. Thus a total count value of less than (n-1) 

1 0 indicates a "do not clean up" status for the asset as a network whole. 

As indicated in Fig. 17, if the global name is not marked for deletion on all 
other machines (ie all except on the machine proposing to carry out the clean up 
routine) then this means that the proposed clean up routine of the object or class 
should be aborted since the object or class is still required, as indicated by step 175. 

1 5 However, if the global name is marked for deletion on all machines, this 

means that no other machine requires this class or object As a consequence, the 
regular clean up routine indicated in step 176 can be, and should be, carried out. 

Fig. 1 8 shows the enquiry made by the machine proposing to execute a clean 
up routine (one of Ml, M2. . .Mn) to the server machine X. The operation of this 
20 proposing machine is temporarily interrupted, as shown in step 1 8 1 and 1 82, until the 
reply is received from machine X, indicated by step 182. 

Fig. 19 shows the activity carried out by machine X in response to such an 
enquiry. The clean up status is determined as seen in step 192 and, if no - the named 
resource is not marked for deletion on (n-1) machines (ie is utilized elsewhere), the 

25 response to that effect is sent to the enquiring machine 194 but the "marked for 

deletion" counter is incremented by one (1), as shown by step 197. Similarly, if the 
answer is yes - the corresponding reply is sent as indicated by steps 195. The waiting 
enquiring machine 1 82 is then able to respond accordingly. As indicated by broken 
lines in Fig. 19, preferably in addition to the yes response shown in step 195, the 

30 shared table is updated so that the status of the globally named asset is changed to 
"cleaned up" as indicated by step 196. 
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Reference is made to the accompanying Annexure C in which: 
Annexure CI is a typical code fragment from an unmodified finalize routine, 
Annexure C2 is an equivalent in respect of a modified finalize routine, and 
Annexure C3 is an equivalent in respect of a modified finalize routine. 

5 

Annexures CI and C2 are the before and after excerpt of a finalize routine 
respectively. The modified code that is added to the method is highlighted in bold. In 
the original code sample of Annexure CI, the finalize method prints 'Deleted..." to 
the computer console on event of finalization (ie deletion) of this object Thus, 
10 without management of object finalization in a distributed environment, each machine 
would re-finalize the same object, thus executing the finalize method more than once 
for a single globally-named object Clearly this is not what the programmer of the 
application program expects to happen. 

15 So, taking advantage of the DRT, the application code is modified as it is 

loaded into the machine by changing the finalize method. The changes made 
(highlighted in bold) are the initial instructions that the finalize method executes. 
These added instructions check if this object is the last remaining object reference by 
calling the isLastReferenceO method, which returns either true or false corresponding 

20 to whether or not this object on this machine is the last of the peer objects to request 
finalization. 

The isLastReferenceO method of the DRT can optionally take an argument 
which represents a unique identifier for this object (See Annexure C3), for example 

25 the name of the object, a reference to the object in question, or a unique number 
representing this object across all nodes, to be used in the determination of the 
finalization status of this class. This way, the DRT can support the finalization of 
multiple objects at the same time without becoming confused as to which of the 
multiple objects are already finalized and which are not, by using the unique identifier 

30 of each object to consult the correct record in the finalization table. 

The DRT can determine the finalization state of the object in a number of 
ways. Preferably, it can ask each machine in turn if their local copy of this object has 
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been marked for finalization, and if any machine replies false, then return true, 
otherwise false. Alternatively, the DRT on the local machine can consult a shared 
record table (perhaps on a separate machine (eg machine X), or a coherent shared 
record table on the local machine, or a database) to determine if this object has been 
5 marked for finalization by all machines except the current machine. 

If the DRT returns false then this means that this object has been marked for 
finalization on all other machine in the distributed environment, and hence, the 
execution of the original finalize code-block is to proceed as this is considered the last 
10 remaining object reference. 

On the other hand, if the DRT returns true, then this means that this object has 
not been marked for finalization by all other machines in the distributed environment, 
as recorded in the shared record table of finalized objects. In such a case, the original 
15 code block is NOT to be executed, as it will potentially invalidate the object on those 
machine(s) that are continuing to use the object and have yet to mark this object for 
finalization. Thus, when the DRT returns true, the inserted three instructions prevent 
execution of the original code, and return straight away to the application program. 

20 Given the fundamental concept of testing to see a clean up is ready to be 

carried out, and if so carrying it out, and if not, not carrying it out, there are several 
different ways in which this concept can be implemented. 

In the first embodiment, a particular machine, say machine M2, loads the clean 
25 up on itself, modifies it, and then loads each of the other machines Ml, M3 ... Mn 
(either sequentially or simultaneously) with the modified routine. In this arrangement, 
which may be termed "master/slave" each of machines Ml, M3, ... Mn loads what it 
is given by machine M2. 

30 In a variation of this "master/slave" arrangement, machine M2 loads the clean 

up routine in unmodified form on machine M2 and then on the other machines deletes 
the clean up routine in its entirety and loads the modified code. Thus in this instance 
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the modification is not a by-passing of the clean up routine but a deletion of it on all 
machines except one. 

In a still further embodiment, each machine receives the clean up routine, but 
5 modifies it and loads the modified routine on that machine. This enables the 
modification carried out by each machine to be slightly different being optimized 
based upon its architecture and operating system, yet still coherent with all other 
similar modifications. 

10 In a further arrangement, a particular machine, say Ml, loads the unmodified 

clean up routine and all other machines M2, M3 . . . Mn do a modification to delete the 
original clean up routine and load the modified version. 

In all instances, the supply can be branched (ie M2 supplies each of Ml, M3, 
15 M4, etc directly) or cascaded or sequential (ie M2 applies Ml which then supplies M3 
which then supplies M4, and so on). 

In a still further arrangement, the machines Ml to Mn, can send all load 
requests to an additional machine X (of Fig. 15), which performs the modification via 

20 any of the afore mentioned methods, and returns the modified routine to each of the 
machines Ml to Mn which then load the modified routine locally. In this 
arrangement, machines Ml to Mn forward all load requests to machine X, which 
returns a modified routine to each machine. The modifications performed by 
machine X can include any of the modifications covered under the scope of the 

25 present invention. 

Persons skilled in the computing arts will be aware of four techniques used in 
creating modifications in computer code. The first is to make the modification in the 
original (source) language. The second is to convert the original code (in say JAVA) 
30 into an intermediate representation (or intermediate language). Once this conversion 
takes place the modification is made and then the conversion is reversed. This gives 
the desired result of modified JAVA code. 
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The third possibility is to convert to machine code (either directly or via the 
abovementioned intermediate language). Then the machine code is modified before 
being loaded and executed. The fourth possibility is to convert the original code to an 
intermediate representation, which is then modified and subsequently converted into 
5 machine code. 

The present invention encompasses all four modification routes and also a 
combination of two, three or even all four, of such routes. 

Turning now to Figs. 20-22, two laptop computers 101 and 102 are illustrated. 
1 0 The computers 101 and 1 02 are not necessarily identical and indeed, one can be an 
IBM or IBM-clone and the other can be an APPLE computer. The computers 101 and 
102 have two screens 105, 1 15 two keyboards 106, 1 16 but a single mouse 107. The 
two machines 101, 102 are interconnected by a means of a single coaxial cable or 
twisted pair cable 314. 

1 5 Two simple application programs are downloaded onto each of the machines 

101, 102, the programs being modified as they are being loaded as described above. 
In this embodiment the first application is a simple calculator program and results in 
the image of a calculator 108 being displayed on the screen 105. The second program 
is a graphics program which displays four coloured blocks 109 which are of different 

20 colours and which move about at random within a rectangular box 310. Again, after 
loading, the box 310 is displayed on the screen 105. Each application operates 
independently so that the blocks 109 are in random motion on the screen 105 whilst 
numerals within the calculator 108 can be selected (with the mouse 107) together with 
a mathematical operator (such as addition or multiplication) so that the calculator 108 

25 displays the result. 

The mouse 107 can be used to "grab" the box 310 and move same to the right 
across the screen 105 and onto the screen 1 15 so as to arrive at the situation illustrated 
in Fig. 21. In this arrangement, the calculator application is being conducted on 
machine 101 whilst the graphics application resulting in display of box 310 is being 
30 conducted on machine 102. 
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However, as illustrated in Fig. 22, it is possible by means of the mouse 107 to 
drag the calculator 108 to the right as seen in Fig. 21 so as to have a part of the 
calculator 108 displayed by each of the screens 105, 115. Similarly, the box 310 can 
be dragged by means of the mouse 107 to the left as seen in Fig. 21 so that the box 
5 310 is partially displayed by each of the screens 105, 1 15 as indicated Fig. 22. In this 
configuration, part of the calculator operation is being performed on machine 101 and 
part on machine 102 whilst part of the graphics application is being carried out the 
machine 101 and the remainder is carried out on machine 102. 

The foregoing describes only some embodiments of the present invention and 
1 0 modifications, obvious to those skilled in the art, can be made thereto without 

departing from the scope of the present invention. For example, reference to JAVA 
includes both the JAVA language and also JAVA platform and architecture. 

Those skilled in the programming arts will be aware that when additional code 
or instructions is/are inserted into an existing code or instruction set to modify same, 
1 5 the existing code or instruction set may well require further modification (eg by 

re-numbering of sequential instructions) so that offsets, branching, attributes, mark up 
and the like are catered for. 

Similarly, in the JAVA language memory locations include, for example, both 
fields and array types. The above description deals with fields and the changes 
20 required for array types are essentially the same mutatis mutandis. Also the present 
invention is equally applicable to similar programming languages (including 
procedural, declarative and object orientated) to JAVA including Micrsoft.NET 
platform and architecture (Visual Basic, Visual C/C 4 *, and C#) FORTRAN, C/C* 4 , 
COBOL, BASIC etc. 

25 The abovementioned embodiment in which the code of the JAVA finalisation 

or clean up routine is modified, is based upon the assumption that either the run time 
system (say, JAVA HOTSPOT VIRTUAL MACHINE written in C and JAVA) or 
the operating system (LINUX written in C and Assembler, for example) of each 
machine Ml . . .Mn will call the JAVA finalisation routine. It is possible to leave the 

30 JAVA finalisation routine unamended and instead amend the LINUX or HOTSPOT 
routine which calls the JAVA finalisation routine, so that if the object or class is not to 
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be deleted, then the JAVA finalisation routine is not called. In order to embrace such 
an arrangement the term "finalisation routine" is to be understood to include within its 
scope both the JAVA finalisation routine and the "combination" of the JAVA 
finalisation routine and the LINUX or HOTSPOT code fragments which call or 
initiate the JAVA finalisation routine. 

The terms object and class used herein are derived from the JAVA 
environment and are intended to embrace similar terms derived from different 
environments such as dynamically linked libraries (DLL), or object code packages, or 
function unit or memory locations. 

The term "comprising" (and its grammatical variations) as used herein is used 
in the inclusive sense of "having 3 * or "including" and not in the exclusive sense of 
"consisting only of*. 

Copyright Notice 

This patent specification contains material which is subject to copyright 
protection. The copyright owner (which is the applicant) has no objection to the 
reproduction of this patent specification or related materials from publicly available 
associated Patent Office files for the purposes of review, but otherwise reserves all 
copyright whatsoever. In particular, the various instructions are not to be entered into 
a computer without the specific written approval of the copyright owner. 
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Annexure A 



The following are program listings in the JAVA language: 

Al . This first excerpt is part of the modification code. It searches through the 
code array, and when it finds a putstatic instruction (opcode 178), it implements the 
modifications. 



// START 

byte[] code « Code_at tribute . code; // Bytecode of a given method in a 

// given classfile. 

int code_length = Code_attribute . code_length; 

int DRT » 99; // Location of the CONSTANT_Methodref_info for the 

// DRT. alert () method. 

for (int i=0; i<code_length; i++) { 

if ((code[i] & Oxff) == 179) { // Putstatic instruction. 

System. arraycopy (code, i+3, code, i+6, code_ length- (i+3) ) ; 

code [i+3] = (byte) 184; // Invokestatic instruction for the 

// DRT. alert () method. 

code[i+4] = (byte) ( (DRT »> 8) & Oxf f ) ; 

codefi+5] - (byte) (DRT & Oxf f ) ; 

} 

} 

// END 

A2. This second excerpt is part of the DRT.alertO method. This is the body of the 
DRT.alertO method when it is called. 

// START 

public static void alert (){ 
synchronized ( ALERT JLOCK) { 

ALERT_LOCK.no tify () ; // Alerts a waiting DRT thread in the background. 

} 

} 

// END 

A3. This third excerpt is part of the DRT Sending, This code fragment shows the 
DRT in a separate thread, after being notified, sending the value across the network. 

// START 

MulticastSocket ms = DRT.getMulticastSocket () ; // The multicast socket 

// used by the DRT for 
// communication. 

byte nameTag « 33; // This is the "name tag" on the network for this 

// field. 
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Field field = modifiedClass.getDeclaredField("myFieldl"); // ^ores^^ 

// from the 
// modified 
// class. 

// In this example, the field is a byte field, 
while (DRT.isRunningO ) { 

synchronized (ALERT_LOCK) { 

ALERT LOCK. wait (); // The DRT thread is waiting for the alert 

// method to be called. 

bytet] b = new byte []{ nameTag, field. getByte (null) } ; // Stores 

// the 
// nameTag 
// and the 
// value 
// of the 
// field from 
// the modified 
// class in a 
// buffer. 

DatagramPacket dp « new DatagramPacket (b, 0, b. length); 
ms.send(dp) ; // Send the buffer out across the network. 



} 

// END 

A4. The fourth excerpt is part of the DRT receiving. This is a fragment of code to 
receive a DRT sent alert over the network. 

/ / START 

MulticastSocJcet ms = DRT.getMulticastSodcet () ; // ^^Jj^g? 

// communication. 

DatagramPacket dp = new DatagramPacket (new byte[2], 0, 2); 

byte nameTag = 33; // This is the "name tag" on the network for this 

// field. 

Field field = modifiedClass.getDeclaredField("myFieldl»); // Stores ^the 

// the modified 
// class. 



// In this example, the field is a byte field, 
while (DRT.isRunning) { 

ms. receive (dp); // Receive the previously sent buffer from the network, 
byte [ ] b = dp . getData ( ) ; 

if fbTOl == nameTag) { // Check the nametags match. 

field. setByte (null, b[l]); // Write the value from the network packet 
11 y // into the field location in memory. 

) 
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// END 

A5. The fifth excerpt is an example application before modification has occurred. 
Method void setValues(int, int) 

0 iload_l 

1 putstatic #3 <Field int staticValue> 

4 aload_0 

5 iload_2 

6 putfield #2 <Field int instanceValue> 

9 return 

A6. The sixth excerpt is the same example application in 5 after modification has 
been performed. The modifications are highlighted in bold. 
Method void setValues(int, int) 

0 iload_l 

1 putstatic #3 <Field int staticValue> 
4 ldc #4 <String "example"> 

6 iconst_0 

7 invokestatic #5 <Method void alert0ava.lang.Object, int)> 

10 aload_0 
lliload_2 

12 putfield #2 <Field int instanceValuO 

15 aload_0 

16 iconst_l 

17 invokestatic #5 <Method void alert(java.lang.Object, int)> 

20 return 

A7. The seventh excerpt is the source-code of the example application used in 
excerpt 5 and 6. 
import java.lang.*; 
public class example { 

/** Shared static field. */ 
public static int staticValue - 0; 

/** Shared instance field. */ 
public int instanceValue = 0; 

/** Example method that writes to memory (instance field) . */ 
public void setValues (int a, int b) { 

staticValue = a; 

instanceValue = b; 

) 
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A8. The eighth excerpt is the source-code of FieldAlert, which alerts the 
"distributed ran-time" to propagate a changed value. 

import java.lang.*; 
import java.util.*; 
import java.net.*; 
import java.io.*; 

public class FieldAlert{ 



/** Table of alerts. */ 

public final static Hashtable alerts = new HashtableO; 



/** Object handle. */ 

public Object reference = null; 



/** Table of field alerts for this object. */ 
public boolean [] fieldAlerts » null; 



/** Constructor. */ 

public FieldAlert (Object o, int initialFieldCount) { 
reference = o; 

fieldAlerts « new boolean [initialFieldCount] ; 

} 



/** Called when an application modifies a value. (Both objects and 
classes) */ 

public static void alert (Object o, int fieldID) { 

// Lock the alerts table, 
synchronized (alerts) { 

FieldAlert alert - (FieldAlert) alerts. get (o) ; 

if (alert == null) { // This object hasn't been alerted already, 

// so add to alerts table, 
alert = new FieldAlert (o, fieldID + 1); 
alerts .put (o, alert) ; 

) 

if (fieldID >« alert . fieldAlerts. length) { 
// Ok, enlarge fieldAlerts array, 
booleant) b = new boolean [ f ieldID+1 ] ; 
System. arraycopy (alert. fieldAlerts, 0, b, 0, 

alert . fieldAlerts . length) ; 
alert. fieldAlerts = b; 

} 

// Record the alert. 

alert. fieldAlerts [fieldID] « true; 

// Mark as pending. 

FieldSend. pending = true; // Signal that there is one or more 

// propagations waiting. 

// Finally, notify the waiting FieldSend thread (s) 
if (FieldSend. waiting) ( 

FieldSend. waiting = false; 

alerts. notify () ; 

} 
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} 

} 



A9. The ninth excerpt is the source-code of FieldSend, which propagates changes 
values alerted to it via FieldAlert. 

import java.lang.*; 
import java.lang. reflect.*; 
import java.util.*; 
import java.net.*; 
import java.io.*; 

public class FieldSend implements Runnable{ 



/** Protocol specific values. */ 

public final static int CLOSE » -1; 

public final static int NACK *= 0; 

public final static int ACK = 1; 

public final static int PROPAGATE_OBJECT «= 10; 

public final static int PROPAGATE~CLASS = 20; 



/** FieldAlert network values. */ 
public final static String group « 

System. getProperty ( ,f FieldAlert_network_group n ) ; 
public final static int port = 

Integer. parselnt (System. getProperty ("FieldAlert^networ^port") ) ; 

/** Table of global ID's for local objects. (hashcode-to-globallD 
mappings) */ 

public final static Hashtable objectToGloballD » new Hashtable(); 

/** Table of global ID's for local classnames. {classname-to-globalID 
mappings) */ 

public final static Hashtable classNameToGloballD « new Hashtable (); 

/** Pending. True if a propagation is pending. */ 
public static boolean pending « false; 

/** Waiting. True if the FieldSend thread (s) are waiting. */ 
public static boolean waiting = false; 

/** Background send thread. Propagates values as this thread is alerted 

to their alteration. */ 
public void run() { 

Sys tern. out. println ( "FieldAlert_network_group= ,f + group); 
System, out. println ( ,1 FieldAlert - network_port=" + port); 

try{ 

// Create a DatagramSocket to send propagated field values. 
DatagramSocket datagramSocket « 

new DatagramSocket (port, InetAddress . getByName (group) ) ; 

// Next, create the buffer and packet for all transmissions. 
byteU buffer = new byte[512]; // Working limit of 512 bytes 

// per packet. 

DatagramPacket datagramPacket « 
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new DatagramPacket (buffer, 0, buffer. length) ; 

while ( ! Thread. interrupted ( ) ) { 

Object [J entries « null; 

// Lock the alerts table, 
synchronized (FieldAlert . alerts) { 

// Await for an alert to propagate something, 
while ( [pending) { 

waiting « true; 

FieldAlert . alerts . wait ( ) ; 

waiting = falser- 



pending = false; 

entries = FieldAlert .alerts . entrySet () .toAr ray () ; 

// Clear alerts once we have copied them. 
FieldAlert . alerts . clear ( ) ; 



// Process each object alert in turn, 
for (int i=0; i<entries .length; i++) { 

FieldAlert alert » (FieldAlert) entries [i]; 

int index = 0; 

datagramPacket . setLength (buffer . length) ; 

Object reference « null; 
if (alert. reference instanceof String) { 
// PROPAGATE_CLASS field operation. 

buffer [index++] - (byte) ( (PROPAGATE_CLASS » 24) & Oxff); 
buffer [index++] - (byte) ( ( PROPAGATE_CLASS » 16) & Oxf f ) ; 
buffer [index++] - (byte) ( (PROPAGATE_CLASS » 8) & Oxf f ) ; 
buffer [index++] - (byte) ( ( PROPAGATE_CLASS » 0) & Oxff); 

String name » (String) alert . reference; 
int length = name . length () ; 

buffer [index++] = (byte) ((length » 24) & Oxf f ) ; 
buffer [index++] - (byte) ((length » 16) & Oxff); 
buffer [index++] « (byte) ((length » 8) & Oxff); 
buffer [index++] - (byte) ((length » 0) & Oxff); 

byte[] bytes - name . getBytes ( ) ; 

System. arraycopy (bytes, 0, buffer, index, length); 
index += length; 

)else{ // PROPAGATE^ OBJECT field operation. 

buffer [index++] - 

(byte) ( ( PRO PAGATE_OB JECT » 24) & Oxff); 
buffer [index++] - 

(byte) ((PROPAGATE OBJECT » 16) & Oxf f ) ; 
buffer [index++] - (byte) ( ( PRO PAGATE_OB JECT » 8) & Oxf f ) ; 
buffer [index++] = (byte) ( (PROP AGATE_OB JECT » 0) & Oxff); 

int globallD « ((Integer) 

objectToGloballD. get (alert, reference) ) •intValueO ; 

buffer [index++] - (byte) ( (globallD » 24) & Oxff); 
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buffer [index++] » (byte) ((globallD » 16) & Oxff); 
buffer [index++] « (byte) ((globallD » 8) & Oxff); 
buffer findex++] - (byte) ((globallD » 0) & Oxff); 



reference « alert. reference; 



// Use reflection to get a table of fields that correspond to 
// the field indexes used internally. 
Field [] fields = null; 
if (reference =« null) { 

fields » FieldLoader.loadClass ( (String) 
alert. reference) , getDeclaredFields () ; 

}else{ 

fields « alert. ref erence. getClass () .getDeclaredFields () ; 

} 

// Now encode in batch mode the fieldlD/value pairs, 
for (int j=0; j<alert. fieldAlerts. length; j++){ 

if (alert.fieldAlerts[j] — false) 
continue; 



buffer [index++] 
buffer [index++] 
buffer [index++] 
buffer [index++] 



(byte) ( ( j » 24) & Oxff); 

(byte) ((j » 16) & Oxff); 

(byte) ((j » 8) & Oxff); 

(byte) ((j » 0) & Oxff); 



// Encode value. 

Class type « fields [j ] .getType () ; 
if (type — Boolean. TYPE) { 

buffer [index++] «=(byte) 

(fields [j] .getBoolean(ref erence) ? 1:0); 
}else if (type — Byte. TYPE) { 

buffer [index++] = fields [j J. getByte (reference) ; 
}else if (type = Short. TYPE) ( 

short v « fields [j] .getShort (reference) ; 

buffer [index++] (byte) ( (v » 8) & Oxff); 

buffer [index++] = (byte) ( (v » 0) & Oxf f ) ; 
}else if (type — Character. TYPE) { 

char v = fields [j ] .getChar (reference) ; 

buffer [index++] = (byte) ( (v » 8) & Oxf f ) ; 

buffer [index++] - (byte) ( (v » 0) & Oxf f ) ; 
}else if (type = Integer. TYPE) { 

int v = fields [j ] .getlnt (reference) ; 

buffer [index++] - (byte) ( (v » 24) & Oxf f ) ; 

buffer [index++] - (byte) ( (v » 16) & Oxff); 

buffer [index++] (byte) ( (v » 8) & Oxf f ) ; 

buffer [index++3 - (byte) ( (v » 0) & Oxf f ) ; 
Jelse if (type — Float. TYPE) { 

int v = Float. f loatToIntBits ( 

fields [j] .getFloat (reference) ) ; 

buffer [index++] = (byte) ( (v » 24) & Oxf f ) ; 

buffer [index++] = (byte) ( (v » 16) & Oxf f ) ; 

buffer [index++] - (byte) ( (v » 8) & Oxf f ) ; 

buffer [index++] = (byte) ( (v » 0) & Oxff); 
)else if (type «== Long. TYPE) { 

long v = fields [j] .getLong( reference) ( 



buffer [index++] = (byte) 

buffer [index++] = (byte) 

buffer [index++] = (byte) 

buffer [index++] « (byte) 

buffer [index++] = (byte) 

buffer [index++] » (byte) 

buffer [index++] » (byte) 



{(v » 56) 

((v » 48) 

((v » 40) 

((v » 32) 

((v » 24) 

((v » 16) 



Oxff) ; 
Oxff) ; 
Oxff) ; 
Oxff) ; 
Oxff) ; 
Oxff) ; 



((v » 8) & Oxff); 
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buffer [index++] « (byte) ( (v » 0) & Oxf f ) ; 
Jelse if (type — Double. TYPE) { 

long v = Double. doubleToLongBits ( 
fields [j] .getDouble (reference) ) ; 

buffer [index++] - (byte) ( (v » 56) 6 Oxf f ) ; 

buffer [index++] = (byte) ( (v » 48) & Oxf f ) ; 

buffer [index++] - (byte) ( (v » 40) & Oxf f ) ; 

buffer [index++] « (byte) ( (v » 32) & Oxf f ) ; 

buffer [index++J = (byte) ( (v » 24) & Oxf f ) ; 

buffer [index++] - (byte) ( (v » 16) & Oxf f ) ; 

buffer [index++] = (byte) ( (v » 8) & Oxf f ) ; 

buffer [index++] - (byte) ( (v » 0) & Oxf f ) ; 
)else{ 

throw new AssertionError ("Unsupported type."); 

) 



) 

// Now set the length of the datagrampacket . 
datagramPacket . setLength (index) ; 

// Now send the packet. 
datagramSocket . send (datagramPacket ) ; 

} 

} 

} catch (Exception e) { 

throw new AssertionError ( "Exception: " + e.toString () ) ; 

} 

) 



A10. The tenth excerpt is the source-code of FieldReceive, which receives 
propagated changed values sent via FieldSend. 

import java.lang.*/ 
import java. lang. reflect .*; 
import java.util.*; 
import java.net.*; 
import java.io.*; 

public class FieldReceive implements Runnable{ 



/** Protocol specific values. */ 

public final static int CLOSE » -1; 

public final static int NACK « 0; 

public final static int ACK « 1; 

public final static int PROPAGATEJDBJECT « 10; 

public final static int PRO PAGATE_CLAS S = 20; 



/** FieldAlert network values, */ 
public final static String group = 

System, get Property ( "FieldAlert_network_group" ) ; 
public final static int port = 

Integer .parselnt (System, get Property ("FieldAlert_network_port") ) ; 
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/** Table of global ID'S for local objects. (globallD- to-hashcode 
mappings) */ 

public final static Hashtable globallDToObject = new HashtableO; 



/** Table of global ID'S for local classnames. (globallD-to-classname 
mappings) */ 

public final static Hashtable globallDToClassNaroe = new HashtableO; 



/** Called when an application is to acquire a lock. */ 
public void run ( ) { 

System, out .println ("FieldAlert_network_group=" + group); 
System. out .println ("FieldAlert_network_port==" + port); 

try{ 

// Create a DatagramSocket to send propagated field values from 
MulticastSocket multicastSocket - new MulticastSocket (port) ; 
multicastSocket. joinGroupdnetAddress.getByName (group) ) ; 

// Next, create the buffer and packet for all transmissions. 
byte[] buffer = new byte [512]; // Working limit of 512 

// bytes per packet. 

DatagramPacket datagraraPacket =» 

new DatagramPacket (buffer, 0, buffer .length) ; 

while ( i Thread . interrupted { ) ) { 

// Make sure to reset length. 
datagramPacket. setLength (buffer. length) ; 

// Receive the next available packet. 
multicastSocket. receive (datagramPacket) ; 

int index « 0, length = datagramPacket. getLength () ; 

// Decode the command. 

int command - (int) (( (buffer [index++] & Oxff) « 24) 
| ( (buffer [index++] & Oxff) « 16) 
I ( (buffer [index++] & Oxff) « 8) 
| (buffer [index++] & Oxff ) ) ; 

if (command ==» PROPAGATE_OBJECT) { // Propagate operation for 

// object fields. 

// Decode global id. 

int globallD = (int) (( (buffer [index++] & Oxff) « 24) 
| ( (buffer [index++] & Oxff) « 16) 
I ( (buffer [index++] & Oxff) « 8) 
I (buffer [index++] & Oxff)); 

// Now, need to resolve the object in question. 
Object reference « globallDToObject .get ( 
new Integer (globallD) ) ; 

// Next, get the array of fields for this object. 

Field { ] fields » reference. getClass ( ) . getDeclaredFields ( ) ; 

while (index < length) ( 

// Decode the field id. 

int fieldID => (int) (( (buffer [index**] & Oxff) « 24) 
I ( (buffer [index++] & Oxff) « 16) 
I ( (buffer [index++] & Oxff) « 8) 
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I (buffer [index++] & Oxff)); 

// Determine value length based on corresponding field 
// type. 

Field field = fields [fieldID] ; 
Class type = field. getType {) ; 
if (type = Boolean. TYPE ) { 

boolean v = (buf fer [index++] 1 ? true : false); 
field. setBoolean (reference, v) ; 
}else if (type — Byte. TYPE) { 
byte v « buffer [index++] ; 
field. setByte (reference, v) ; 
}else if (type — Short. TYPE) { 

short v = (short) ( ( (buf fer [index++] & Oxff) « 8) 

I (buffer [index++] & Oxff)); 
field. setShort (reference, v) ; 
}else if (type «=» Character . TYPE) { 

char v « (char) ( ( (buf fer [index++] & Oxff) « 8) 

I (buffer[index++J & Oxff)); 
field. setChar (reference, v) ; 
}else if (type == Integer. TYPE) { 

int v o (int) ( ( (buf f er [index++] & Oxff) « 24) 
I ( (buffer [index++] & Oxff) « 16) 
I ( (buffer [index++] & Oxff) « 8) 
I (buffer [index++] & Oxff)); 
field. setlnt (reference, v) ; 
}else if (type == Float. TYPE) { 

int v = (int) ( ( (buf fer [index++] & Oxff) « 24) 
I ( (buffer [index++] & Oxff) « 16) 
I ( (buffer [index++] & Oxff) « 8) 
I (buffer [index++] & Oxff)); 
field. setFloat (reference, Float . intBitsToFloat (v) ) ; 
}else if* (type — Long. TYPE) { 

long v= (long) ( ( (buf fer [index++] & Oxff) « 56) 
| ( (buffer [index++] & Oxff) « 48) 
I ( (buffer [index++] & Oxff) « 40) 
I ( (buffer [index++] & Oxff) « 32) 
i ( (buffer [index++] & Oxff) « 24) 
| ( (buffer [index++] & Oxff) « 16) 
I ( (buffer [index++] & Oxff) « 8) 
I (buffer [index++] & Oxf f ) ) ; 
field. setLong (reference, v) / 
}else if (type — Double . TYPE) { 

long v = (long) ( ( (buf f er [index++] & Oxff) « 56) 
| ( (buffer [index++] & Oxff) « 48) 
| { (buffer [index++] & Oxff) « 40) 
I ( (buffer [index++3 & Oxff) « 32) 
J ( (buffer [index++] & Oxff) « 24) 
1 ( (buffer [index++] & Oxff) « 16) 
I ( (buffer [index++] & Oxff) « 8) 
I (buffer [index-H-] & Oxf f ) ) ; 
field. setDouble (reference, Double . longBitsToDouble (v) ) ; 
}else{ 

throw new AssertionError ("Unsupported type.")/ 



)else if (command — PROPAGATE_CLASS) { // Propagate an update 

// to class fields. 

// Decode the classname. 

int nameLength « (int) (( (buffer [index++] & Oxff) « 24) 
I ( (buffer [index++] & Oxff) « 16) 
| ( (buffer [index++] & Oxff) « 8) 
| (buffer [index++] & Oxf f ) ) ; 
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String name = new String (buffer, index, nameLength) ; 
index += nameLength; 

// Next, get the array of fields for this class. 
Field [] fields = 

FieldLoader . loadClass (name) . getDeclaredFields ( ) ; 

// Decode all batched fields included in this propagation 
// packet. 

while (index < length) { 
// Decode the field id. 

int fieldID = (int) (( (buffer [index++] & Oxff) « 24) 
| { (buffer [index++] & Oxff) « 16) 
| ( (buffer [index++] & Oxff) « 8) 
| (buffer [index++] & Oxff)); 

// Determine field type to determine value length. 
Field field « fields [fieldID] ; 
Class type = field. getType () ; 
if (type =~ Boolean. TYPE) { 

boolean v = (buf fer [index++] «= 1 ? true : false); 
field . setBoolean (null, v) ; 
}else if (type ==» Byte. TYPE) { 
byte v = buffer [index++] ; 
field. setByte (null, v) ; 
}else if (type == Short. TYPE) { 

short v = (short) ( ( (buf fer [index++] & Oxff) « 8) 

| (buffer [index++3 & Oxff)); 
field. setShort (null, v) ; 
}else if (type — Character .TYPE) { 

char v - (char) ( ( (buf fer [index++] & Oxff) « 8) 

| (buffer [index++] & Oxff)); 
field. setChar (null, v) ; 
)else if (type Integer .TYPE) { 

int v = (int) (( (buffer [index++] & Oxff) « 24) 
| ( (buffer [index++] & Oxff) « 16) 
1 ( (buffer [index++] & Oxff) « 8) 
| (buffer [index++] & Oxf f ) ) ; 
field. setlnt (null, v) ; 
}else if (type =» Float. TYPE) { 

int v = (int) (( (buffer [index++] & Oxff) « 24) 
| ( (buffer [index++] & Oxff) « 16) 
| ( (buffer [index++] & Oxff) « 8) 
| (buffer [index++] & Oxf f ) ) ; 
field. setFloat (null, Float .intBitsToFloat (v) ) ; 
Jelse if (type Long. TYPE) { 

long v = (long) ( ( (buf fer [index++] & Oxff) « 56) 
| ( (buffer [index++] & Oxff) « 48) 
| ( (buffer [index++] & Oxff) « 40) 
| ( (buffer [index++] & Oxff) « 32) 
| ( (buffer [index++] & Oxff) « 24) 
| ( (buffer [index++] & Oxff) « 16) 
1 ( (buffer [index++] & Oxff) « 8) 
| (buffer [index++] & Oxf f ) ) ; 
field. setLong (null, v) ; 
}else if (type Double. TYPE) { 

long v « (long) ( ( (buf fer [index++] & Oxff) « 56) 
| ( (buffer [index++] & Oxff) « 48) 
| ( (buffer [index++] & Oxff) « 40) 
| ( (buffer [index++] & Oxff) « 32) 
| ( (buffer [index++] & Oxff) « 24) 
| { (buffer [index++] & Oxff) « 16) 
| ( (buffer [index++] & Oxff) « 8) 
| (buffer [index++] & Oxff)); 
field. setDouble (null, Double. longBitsToDouble (v) ) ; 
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}else{ // Unsupported field type. 

throw new AssertionError ("Unsupported type."); 

) 

} 

} 

} 

} catch (Exception e) { 

throw new AssertionError ("Exception: " + e. toStrmg ( ) ) ; 

} 

} 



} 

All.FieldLoader.java , . 

This excerpt is the source-code of FieldLoader, which modifies an application as it is 

being loaded. 

import java.lang.*; 
import java.io.*; 
import java.net.*; 

public class FieldLoader extends URLClassLoader { 

public FieldLoader (URL (] urls) { 
super (urls) ; 

) 

protected Class findClass (String name) 
throws ClassNotFoundException{ 

ClassFile cf = null; 

try{ 

BufferedlnputStream in = 

new BufferedlnputStream ( f indResource ( 

name . replace ( ' . \ ' / ' ) . concat ( " . class" ) ) . openStream ( ) ) ; 
cf - new ClassFile (in) ; 
) catch (Exception e) {throw new ClassNotFoundException(e.toString() ) ; } 

// Class-wide pointers to the ldc and alert index, 
int ldcindex = -1; 
int alertindex = -1; 

for (int i=0; i<cf .methods_count; i++) { 

for (int j»0; j<c£ .methods [i] . attributes_count; j++) { 

if (I (cf. methods [i] .attributes [j] instanceof Code_attnbute) ) 
continue; 

Code_attribute ca - (Code_attribute) 
cf. methods [i] .attributes [j ] ; 

boolean changed » false; 

for (int z=0; 2<ca. code. length; z++) { 
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PUTSTATIC 



fields 



if (<ca.code[z][0] & Oxff) — 179) { // Opcode for a 

// instruction. 

changed ° true; 

// The code below only supports fields in this class. 

// Thus, first off, check that this field is local to this 

CONSTANT* Fieldref info fi = (CONSTANT_Fieldref J.nfo) 

cf. constant pool [ (int) ( ( (ca . code [z] [1] & Oxff) « 8) I 

(ca.code[z]T2J & Oxff))]; 
CONSTANT_Class_info ci = ( CONST ANT_Class_info) 

cf . constant j? 001 [ f i . class_index] ; 
String className = t 

cf . constant_pool [ci . naroe_index] . toStrmg ( ) ; 
if (! name. equals (className) ) { 

throw new AssertionError ("This code only supports 



"local to this class"); 



} 



// Ok, now search for the fields name and index. 

CONSTANT^Nlm^AndType^info ni - <CONSTANT_NameAndType_info) 
cf . const an t_pool [ f i . name_and_type_index] ; 

String fieldName = 

cf .constantj?ool[ni.name_index] .toStringO ; 
for (int a=0; a<cf . fields_count; a++) { 
String fn - cf . constant_pool [ 

cf . fields [a] . name_index] . toString ( ) ; 
if ( fieldName. equals (fn) ) { 
index = a; 
break; 

} 

} 

// Next, realign the code array, making room for the 
// insertions. 

byte[] [] code2 « new byte [ca.code. lengtn+3] []; 
System. arraycopy (ca. code, 0, code2, 0, z+1); 
System. arraycopy (ca. code, z+1, code2, z+4, 

ca . code . length- ( z+1 ) ) ; 
ca.code = code2; 

// Next, insert the LDC_W instruction, 
if (Idcindex — -1) { 

CONSTANT_String_info csi = 

new CONSTANT_String_inf o (ci . name_index) ; 

cp_info[] cpi - new cp_info[cf . constant jpool.length+1] ; 

System, arraycopy (cf. constant jpool, 0, cpi, 0, 
cf .cons tant_pool. length) ; 

cpi [cpi. length - 1] « csi; 

Idcindex = cpi .length-1; 

cf . constant jpool = cpi; 

cf . constant_pool_count++; 

ca.code[z+l] - new byte[3]; 
ca.code[z+l] [0] = (byte) 19; 

ca.code[z+l][13 - (byte) ((Idcindex » 8) & Oxff ) ; 
ca.code [z+1] [2] = (byte) (Idcindex & Oxf f ) ; 



// Next, insert the SIPUSH instruction. 
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ca.code[z+2] = new byte [3]; 
ca.codeCz+2] [0] - (byte) 17/ 

ca.code[z+2] [1] = (byte) ((index » 8) & Oxf f ) ; 
ca.code[z+2] [2] « (byte) (index & Oxf f ) ; 

// Finally, insert the INVOKESTATIC instruction, 
if (alertindex — -1) { 

// This is the first time this class is encourtering 

the 

// alert instruction, so have to add it to the constant 
// pool. 

cp_info[] cpi = new cp_info[cf .constant jpool. length* 6] ; 
System. arraycopyfcf .constant jpool, 0, cpi, 0, 

cf . constant jpool . length) ; 
cf. constant jpool =» cpi; 
cf .constantjpool_count += 6; 

CONSTANT_Utf8_info ul - 

new CONSTANTJJtf8_info("FieldAlert") ; 
cf. cons tant_pool[cf .constantjool. length- 6] » ul; 

CONSTANT_Class_info cl = new CONSTANT_Class_inf o ( 

cf . constant jpool jsount- 6) ; 
cf .constant jpool [cf . constant jpool .length-5] cl; 

ul « new CONSTANTJJtf8_info( "alert") ; 

cf. constant jpool tcf.constant_pool.length-4] « ul; 

ul - new CONSTANT_Utf8_info(" (Ljava/lang/Object;I) V") ; 
cf .const ant jpool [cf . constant jpool .length-3] = ul; 

CONSTANT_NameAndType_info nl « 
new CONSTANT_NameAndType_info( 

cf . cons tant_pool • length- 4 , cf . const an t_pool . length- 

3) ; 

cf ,constant_pool[cf ,constant_pool .length-2] = nl; 

CONSTANT_Methodref_info ml - new 
CONSTANT_Methodref_inf o ( 

cf . constant_pool . length-5, cf. constant jpool . length- 

2); 

cf . constant jpool [cf. constant jpool .length-1] = ml; 
alertindex » cf . constant_pool . length-1; 

) 

ca.codetz+3] = new byte [3]; 
ca.code[z+3] [0] = (byte) 184; 

ca.code[z+3] [1] = (byte) ((alertindex » 8) & Oxf f ) ; 
ca.code[z+3] [2] » (byte) (alertindex & Oxf f ) ; 



// And lastly, increase the CODE_LENGTH and 

ATTRIBUTE_LENGTH 

// values. 

ca.code_length +« 9; 
ca.attribute_length +« 9; 

} 

) 

// If we changed this method, then increase the stack size by 

one. 

if (changed) { 

ca.max_ stack++; // Just to make sure. 

} 
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} 

} 



try{ 

ByteArrayOutputStream out » new ByteArrayOutputStrearaO ; 

cf. serialize (out) ; 

bytef] b = out. toByteArray () ; 

return def ineClass (name, b, 0, b. length) ; 

) catch (Exception e) { 

throw new ClassNotFoundException (name) ; 

} 

} 

} 

A12. Attributejnfo.java 

Convience class for representing attributejnfo structures within ClassFiles. 

import java.lang. *; 
import java.io,*; 

/** This abstract class represents all types of attribute_info 

* that are used in the JVM specifications. 

* All new attribute_info subclasses are to always inherit from this 

* class. 
*/ 

public abstract class attribute_info{ 

public int attribute_name_index; 
public int attribute_length; 

/** This is used by subclasses to register themselves 

* to their parent classFile. 
*/ 

attribute_info (ClassFile cf){) 

/** Used during input serialization by ClassFile only. */ 
attribute_info (ClassFile cf, DatalnputStream in) 
throws IOException{ 

attribute_name_index = in.readChar () ; 
attribute_length = in. readlnt ( ) ; 

} 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 

throws IOException{ 

out .writeChar (attribute_name_index) ; 

out.writelnt (attribute_length) ; 

} 

/** This class represents an unknown attribute_info that 

* this current version of classfile specification does 
+ not understand. 

*/ 

public final static class Unknown extends attribute__info{ 
byte[] info; 
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/** Osed during input serialization by ClassFile only. */ 
Unknown (ClassFile cf, DatalnputStreara in) 

throws IOException{ 

super (cf, in); 

info = new byte [attribute_length] ; 
in.read(info, 0, attribute_length) ; 

) 

/** Osed during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 
throws IOException{ 

ByteArrayOutputStream baos = new ByteArrayOutputStream ( ) ; 

super. serialize (out) ; 

out. write (info, 0, attribute_length) ; 



A13. ClassFilcjava 

Convience class for representing ClassFile structures. 

import java.lang.*; 
import java.io.*; 
import java.util.*; 

/*+ The ClassFile follows verbatim from the JVM specification. */ 
public final class ClassFile { 

public int magic; 

public int minor_version; 

public int major_version; 

public int constant_pool_count; 

public cp_info[] constant^pool; 

public int access_f lags ; 

public int this_class; 

public int super_class; 

public int inter faces_count; 

public int[] interfaces; 

public int f ields_count; 

public field_info[] fields; 

public int methods_count; 

public method_inf o [ ] methods; 

public int attributes_count; 

public attribute_info[] attributes; 

/** Constructor. Takes in a byte stream representation and transforms 

* each of the attributes in the ClassFile into objects to allow for 

* easier manipulation. 

*' i 
public ClassFile (InputStream ins) 

throws IOException{ 

DatalnputStream in = (ins instanceof DatalnputStream? 

(DatalnputStream) ins : new DatalnputStream (ins) ) ; 
magic « in.readlnt () ; 
minorjversion = in. readChar () ; 
major_version - in. readChar ( ) ; 
constant_pool_count = in. readChar () ; 
constant pool = new cp_info [constant_pool_count] ; 
for (int i<constant_pool_count; i++) { 

in. mark (1) ; 

int s - in. read () ; 

in. reset () ; 

switch (s) { 
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case 1: 

constant_pool [i] 

break; 
case 3: 

constant_pool [i] 

break; 
case 4: 

constant_pool [i] 

break; 
case 5: 

cons tan t_pool [i] 

i++; 

break; 
case 6: 

constant_pool [i] 

i++; 

break; 
case 7 : 

constantjpool [i] 

break; 
case 8: 

constantjpool [i] 

break; 
case 9: 

constant_pool [i] 

break; 
case 10: 

constantjpool [i] 

in); 

break; 
case 11: 

constantjpool [i] 

new CONSTANT_InterfaceMethodref_info(this, in); 

break; 
case 12: 

constantjpool [i] « new CONSTANT JJaraeAndType_info (this, 

in); 

break; 
default: 

throw new Cla ss Forma tErr or ("Invalid ConstantPoolTag") ; 

} 

} 

access_flags = in. readChar () ; 
this_class = in. readChar () ; 
super_class - in . readChar () ; 
interfaces_count = in. readChar () ; 
interfaces » new int [interfaces_count] ; 
for (int i=0; i<interf aces_count; i++) 

interfaces [i] = in. readChar () ; 
fields_count « in. readChar () ; 
fields = new field_info [fields_count] ; 
for (int i=0; i<f ields_count; i++) { 

fields[i] «■ new field_info (this, in); 

) 

methods_count = in. readChar () ; 

methods = new method_info [methods_count] ; 

for (int i=0; i<methods_count; i++) { 

methods [i] » new method__info (this, in); 

} 

attributes_count » in. readChar () ; 

attributes « new attribute_info[attributes_count] ; 
for (int i=0; i<attributes_count; i++) { 
in.mark(2) ; 

String s =» constantjpool [in. readChar ( ) ] .toSt ring () ; 
in. reset () ; 

if (s. equals ("SourceFile") ) 



=> new CONSTANT_Utf8_info(this, in); 
= new CONSTANT_Integer_info(this, in); 
« new CONSTANT_Float_info(this, in); 
« new CONSTANT_Long_info (this, in); 

= new CONSTANT_Double_info(this, in); 

*= new CONSTANT_Class_info(this, in); 
= new CONSTANT_String_info(this, in) ; 
= new CONSTANT_Fieldref_info(this, in); 
« new CONSTANT_Methodref_info(this, 
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attributes [i] = new SourceFile_attribute (this, in); 
else if (s. equals ("Deprecated") ) 

attributes [i] = new Deprecated_attribute (this, in); 
else if (s. equals ("InnerClasses") ) 

attributes [i] = new InnerClasses_attribute (this, in); 

else 

attributes [i] = new attribute_info. Unknown (this, in); 

) 

) 

/** Serializes the ClassFile object into a byte stream. */ 
public void serialize (OutputStreara o) 
throws IOException{ 

DataOutputStream out « (o instanceof DataOutputStreara ? 

(DataOutputStream) o : new DataOutputStream (o) ) ; 
out. writelnt (magic) ; 
out.writeChar (minor_version) / 
out . writeChar (majo reversion) ; 
out . writeChar (constant_pool_count ) ; 
for (int i=l; i<constant_pool_count; i++) { 
constant_j)ool [i] . serialize (out) ; 

if (constant_j>ool[i] instanceof CONSTANT_Long_info I! 

constant_pool[i] instanceof CONSTANT_Double_ inf o) 

i++; 

) 

out.writeChar (access_f lags) ; 

out .writeChar (this_class) ; 

out .writeChar (superclass) ; 

out . writeChar (interf aces_count) ; 

for (int i=0; i<interfaces_count; i++) 

out.writeChar (interf aces [i] ) ; 
out.writeChar (fields_count) ; 
for (int i=0; i<f ields_count; i++) 

fields [i] .serialize (out) ; 
out.writeChar (methods_count) ; 
for (int i=0; i<methods_count; i++) 

methods [i] . serialize (out) ; 
out . writeChar (attributes_count ) ; 
for (int i=0; i<attributes_count; i++) 

attributes [i] . serialize (out) / 
// Flush the outputstream just to make sure, 
out. flush () ; 

} 



A14. Code_attribute.java 

Convience class for representing Code_attribute structures within ClassFiles. 

import java.util.*; 
import j ava . lang . * / 
import java.io.*; 

/** 

* The coded is stored as a 2D array. */ 
public final class Code_attribute extends attribute_info{ 

public int max_stack; 

public int max_locals; 

public int code_length; 

public byte[] [] code; 

public int exception_table_length; 

public exception_table[] exception_table; 

public int attributes_count; 

public attribute_info[] attributes; 
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/** Internal class that handles the exception table. */ 
public final static class exception_table{ 

public int startjpc; 

public int end_ pc; 

public int handle r_pc; 

public int catch_type; 

} 

/** Constructor called only by method_info. */ 

Code_attribute (ClassFile cf, int ani, int al, int ras, int ml, int cl, 
byte(][] cd, int etl, exception_table [] et, int ac, 
attribute_info[] a) { 

super (cf) / 

attribute_name_index = ani; 
attribute_length = al; 
max_stack = ras; 
raax_locals = ml; 
code_length « cl; 
code = cd; 

exception_table_length - etl; 
except ion_table = et; 
attributes_count = ac; 
attributes « a ; 

) 

/** Used during input serialization by ClassFile only. */ 
Code_attribute (ClassFile cf, Data InputSt ream in) 

throws IOException{ 

super (cf, in); 

raax_stack « in.readChar () ; 

max_locals = in. readChar { ) ; 

code_length = in.readlnt () ; 

code = new byte [code_length] [ 3 ; 

int i « 0; 

for (int pos=0; pos<code_length; i++) { 
in.mark(l) ; 
int s - in. read () ; 
in. reset () ; 
switch (s){ 

case 16: 

case 18: 

case 21: 

case 22: 

case 23: 

case 24: 

case 25: 

case 54 : 

case 55: 

case 56: 

case 57: 

case 58: 

case 169: 

case 188: 

case 196: 

code[i] = new byte [2]; 
break; 

case 17: 

case 19: 

case 20: 

case 132: 

case 153: 

case 154: 

case 155: 

case 156: 
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case 157: 
case 158: 
case 159: 
case 160: 
case 161: 
case 162: 
case 163: 
case 164: 
case 165: 
case 166: 
case 167: 
case 168: 
case 178: 
case 179: 
case 180: 
case 181: 
case 182: 
case 183: 
case 184: 
case 187: 
case 189: 
case 192: 
case 193: 
case 198: 
case 199: 
case 209: 

code[i] = new byte [3]; 

break; 
case 197: 

code[i] = new byte [4]; 

break; 
case 185: 
case 200: 
case 201: 

code[i] = new byte [5]; 

break; 
case 170: { 

int pad = 3 - {pos % 4); 

in.mark(pad+13) ; // highbyte 

in.skipBytes (pad+5) ; // lowbyte 

int low « in.readlnt () ; 
code[i] = 

new byte [pad + 13 + ( (in.readlnt () - low +1) * 4)]; 
in. reset () ; 
break; 
lease 171: { 

int pad = 3 - (pos % 4) ; 
in.mark(pad+9) ; 
in.skipBytes (pad+5) ; 

code[i] = new byte [pad + 9 + (in. readlnt ( ) * 8)]; 
in. reset () ; 
break; 
} default: 

code[i] = new byte[l]; 

} 

in. read ( code [i] , 0, code[i] .length) ; 
pos +« code [i ] .length; 

) 

// adjust the array to the new size and store the size 
byte[] [] temp = new byte[i] []; 
System. arraycopy (code, 0, temp, 0, i) ; 
code « temp; 

exception_table_length = in.readChar () ; 
exception_table = 
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new Code_attribute.exception_table[exception_table_length] ; 
for (i«=0; i<exception_table_length; i++) { 

exception_table [i] » new exception_table ( ) ; 
exception_table [i] . startjpc - in. readChar { ) ; 
except ion_table [i] .endjpc = in. readChar {) ; 
exception_table [i] ,handler_pc = in. readChar () ; 
exception_table [i] .catch_type = in. readChar () ; 

} 

attributes_count = in. readChar () ; 

attributes » new attribute_info [attributes_count] ; 
for (i=0; i<attributes_count; i++) { 
in.raark(2) ; 

String s ■ cf . constant^pool [in. readChar () ].. toString () ; 
in. reset { ) ; 

if (s .equals ("LineNumberT able") ) 

attributes [i] = new LineNuraberTable_attribute (cf , in); 
else if (s. equals ("LocalVariableTable") ) 

attributes [i] = new LocalVariableTable_attribute (cf , in); 

else 

attributes [i] « new attribute_info. Unknown (cf, in); 

) 

} 

/** Used during output serialization by ClassFile only. 
*/ 

void serialize (DataOutputStream out) 
throws IOException{ 

attribute_length = 12 + code_length + 

(exception_table_length * 8); 
for (int i=0; i<attributes_count; i++) 

attribute_length +■ attributes [i] . attribute_length + 6; 
super . serialize (out) ; 
out .writeChar (max_stack) ; 
out .writeChar (raax_locals ) ; 
out .write Int (code_length) ; 

for (int i=0, pos=0; pos<code_length; i++) { 
out . write ( code [ i ) , 0 , code [ i ] . length ) ; 
pos += code [i] .length; 

} 

out. writeChar (exception_table_length) ; 

for (int i«0; i<exception_table_length; i++) { 

out .writeChar (exception_table [i] . start_pc) ; 

out .writeChar (exception_table [i] .end_pc) ; 

out. writeChar (exception_table [i] .handler_pc) ; 

out .writeChar (except ion_table[i] .catch_type) ; 

) 

out .writeChar (attributes_count) ; 
for (int i=0; i<attributes_count; i++) 
attributes [i] . serialize (out) ; 



A15. CONSTANT j:iassJtofo.java 

Convience class for representing CONSTANT_Class_info structures within 
ClassFiles. 



import java.lang.*; 
import java.io.*; 

/** Class subtype of a constant pool entry. */ 

public final class CONSTANT_Class_info extends cp_info{ 
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/** The index to the name of this class. */ 
public int narae_index = 0; 

/** Convenience constructor. 
*/ 

public CONSTANT_Class_info(int index) { 
tag «= 7; 

name_index » index; 

) 

/** Used during input serialization by ClassFile only. */ 
CONSTANT_Class_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

if (tag != 7) 

throw new ClassFormatError () ; 

name_index - in . readChar ( ) ; 

} 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 

throws IOException{ 

out.writeByte(tag) ; 

out.writeChar (name_index) ; 

} 



) 

A16. CONSTANT JDoubleJnfo.java 

Convience class for representing CONSTANT__Double_info structures within 
ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Double subtype of a constant pool entry. */ 

public final class CONSTANT J)ouble_info extends cp_mfo{ 

/** The actual value. */ 
public double bytes; 

public CONSTANT_Double_info (double d) { 
tag 5=3 6; 
bytes = d; 

} 

/** Used during input serialization by ClassFile only. */ 
CONSTANT_Double_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

if (tag !« 6) 

.throw new ClassFormatError () ; 

bytes = in . readDouble ( ) ; 

) 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 

throws IOException{ 

out.writeByte(tag) ; 

out. writeDouble (bytes) ; 

long 1 « Double. doubleToLongBits (bytes) ; 

) 
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A17. CONSTANT_Fieldref.info.java 

Convience class for representing CONSTANT J^ieldrefjnfo structures within 
ClassFiles. 



import java.lang.*; 
import java.io.*; 

/** Fieldref subtype of a constant pool entry- */ 

public final class CONSTANT_Fieldref_info extends cp_info{ 

/** The index to the class that this field is referencing to. */ 
public int class_index; 

/** The name and type index this field if referencing to. */ 
public int name_and_type_index ; 

/** Convenience constructor. */ 

public CONSTANT_Fieldref_info(int class_index, int name_and_type_index) 

( 

tag = 9; 

this . class_index = class_index; 

this.name_and type_index « name_and_type_index; 

) 

/** Osed during input serialization by ClassFile only. */ 
CONSTANT_Fieldref_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

if (tag !« 9) 

throw new Class FormatError ( ) ; 

class_index = in. readChar () ; 

name_and_type_index = in. readChar () ; 

} 

/** Used during output serialization by ClassFile only. */ 
void serialize ( DataOutputStream out) 

throws IOException{ 

out. writeByte (tag) ; 

out.writeChar (class_index) ; 

out. writeChar (name_and_type_index) ; 

) 



A18. CONSTANT JFloat_info.java 

Convience class for representing CONSTANT J^oatjnfo structures within 
ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Float subtype of a constant pool entry. */ 

public final class CONSTANT_Float_info extends cp_info{ 

/** The actual value. */ 
public float bytes; 

public CONSTANT_Float_info (float f ) { 
tag = 4; 
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bytes •= f; 

} 

/** Used during input serialization by ClassFile only. */ 
CONSTANT_Float_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

if (tag != 4) 

throw new ClassFormatError () ; 

bytes = in.readFloat () ; 

) 

/** Used during output serialization by ClassFile only. */ 
public void serialize (DataOutputStream out) 

throws IOException{ 

out . writeBy te ( 4 ) ; 

out. writeFloat (bytes) ; 

} 

} 

A19. CONSTANT _Integer_info.java 

Convience class for representing CONSTANT Jntegerjnfo structures within 
ClassFiles. 

import j ava . lang . * ; 
import java.io.*; 

/** Integer subtype of a constant pool entry. */ 

public final class CONSTANT_Integer_info extends cp_info{ 

/** The actual value. */ 
public int bytes; 

public CONSTANT_Integer_info(int b) { 
tag = 3; 
bytes = b; 

) 

/** Used during input serialization by ClassFile only. */ 
CONSTANT_Integer_inf o ( ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in) ; 

if (tag != 3) 

throw new ClassFormatError ( ) ; 

bytes - in.readlnt () ; 

} 

/** Used during output serialization by ClassFile only. */ 
public void serialize (DataOutputStream out) 

throws IOException{ 

out.writeByte(tag) ; 

out. writelnt (bytes) ; 

) 



A20 CONSTANT_InterfaceMethodref_info.java 

Convience class for representing CONSTANT_InterfaceMethodref.info structures 
within ClassFiles. 
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import java.lang.*; 
import java.io.*; 

/** mterfaceMethodref subtype of a constant pool entry. 

public final class CONSTANT_InterfaceMethodref_info extends cp_info{ 

/** The index to the class that this field is referencing to. */ 
public int class_index; 

/** The name and type index this field if referencing to. */ 
public int name_and_type_index; 

public CONSTANT Interf aceMethodref_inf o (int class_index, 

y - int name_and_type_index) { 

tag = la- 
this. class_index = class_index; 
this.name_and_type_index = name_and_type_index; 

} 

/** Used during input serialization by ClassFile only. */ 
CONSTANT^InterfaceMethodref_info(ClassFile cf, DatalnputStream in) 

throws IOException{ 
super (cf, in); 
if (tag I- 11) 

throw new ClassFormatError () ; 
class_index =» in. readChar ( ) ; 
name_and_type_index = in. readChar () ; 

} 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 

throws IOExceptionl 

out.writeByte(tag) ; 

out.writeChar (class_index) ; 

out . writeChar (name_and_type_index) ; 

} 



A21 . CONSTANT J,ongJnfo.java 

Convience class for representing CONSTANT_Long_info structures within 
ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Long subtype of a constant pool entry. */ 

public final class CON S TAN T_Lo ng_i n f o extends cp_info{ 

/+* The actual value. */ 
public long bytes; 

public CONSTANT_Long_info(long b) { 
tag = 5; 
bytes « b; 

) 

/** Used during input serialization by ClassFile only. */ 
CONSTANT_Long_info (ClassFile cf, DatalnputStream in) 
throws IOException{ 
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super (cf, in); 
if (tag 5) 

throw new Class FormatError () ; 
bytes « in . readLong ( ) ; 

} 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 

throws IOException{ 

out .writ eByte (tag) ; 

out. writeLong (bytes) ; 

) 



} 

A22. CONSTANT_Methodref_iiifo.java 

Convience class for representing CONSTAOT_Methodref_info structures within 
ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Methodref subtype of a constant pool entry. 
V 

public final class CONSTANT_Methodref_info extends cp_info{ 

/** The index to the class that this field is referencing to. */ 
public int class_index; 

/** The name and type index this field if referencing to. */ 
public int name_and_type_ index; 

public CONSTANT_Methodref_info(int class_index, int name_and_type_index) 

{ 

tag = 10; 

this.class_index « class_index; 

this .name_and_type_index =» naroe_and_type_index ; 

) 

/** Used during input serialization by ClassFile only. */ 
CONSTANT JtfethodrefjLnfo (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

if (tag 10) 

throw new ClassFormatError {) ; 

class_index « in . readChar ( ) ; 

name_and_type_index = in. readChar () ; 

) 

/** Used during output serialization by ClassFile only. V 
void serialize (DataOutputStream out) 

throws IOException{ 

out.writeByte (tag) ; 

out .writeChar (class_index) ; 

out. writeChar (name_and_type_index) ; 

) 



) 

A23. CONSTANT^NameAndType^info.java 
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Convience class for representing CONSTANT_NameAndType_info structures within 
ClassFiles. 



import java.io.*; 
import java.lang.*; 

/** NameAndType subtype of a constant pool entry. 
*/ 

public final class CONSTANT_NameAndType_info extends cp_info{ 

/** The index to the Utf8 that contains the name- */ 
public int naroe_index; 

/** The index fo the Utf8 that constains the signature. */ 
public int descriptor_index; 

public CONSTANTJJameAndType_info(int name_index, int descriptor_index) { 
tag =12; 

this.name_index =• nazne_index; 
this.descriptor_index = descriptor_index; 

) 

/** Used during input serialization by ClassFile only. */ 
CONSTANT_NameAndType_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in) ; 

if (tag 12) 

throw new ClassFormatError () ; 

name_index « in.readChar () ; 

descr iptor_index = in . readChar ( ) ; 

> 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStreara out) 

throws IOException{ 

out.writeByte (tag) ; 

out .writeChar (name_index) ; 

out. writeChar (descriptor index) ; 

) 



) 

A24. CONSTANT^StringJnfo.java 

Convience class for representing CONSTANTJStringJtafo structures within 
ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** String subtype of a constant pool entry. 
*/ 

public final class CONSTANT_String_info extends cp_jinfo{ 

/** The index to the actual value of the string. */ 
public int string_index; 

public CONSTANT_String_info(int value) { 
tag =» 8; 

string_index = value; 

} 
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/*+ ONLY TO BE USED BY CLASS FILE! */ 

public CONSTANT_String_info (ClassFile cf, DatalnputStream in) 
throws IOException{ 
super (cf, in); 
if (tag != 8) 

throw new Class FormatError () ; 
string index = in. readChar () ; 

} 

/** Output serialization, ONLY TO BE USED BY CLASS FILE ! */ 
public void serialize (Da taOutputSt ream out) 

throws IOException{ 

out.writeByte (tag) ; 

out. writeChar (string_index) ; 



) 

A25. CONSTANT_Ut£8Jnfo.java 

Convience class for representing CONSTANT_Utf8_info structures within 
ClassFiles. 

import java.io.*; 
import java.lang.*; 

/** UtfB subtype of a constant pool entry. 

* We internally represent the Utf8 info byte array 

* as a String. 
*/ 

public final class CONSTANTJJtf 8_info extends cp_info{ 

/** Length of the byte array. */ 
public int length; 

/** The actual bytes, represented by a String. */ 
public String bytes; 

/** This constructor should be used for the purpose 

* of part creation. It does not set the parent 

* ClassFile reference. 
*/ 

public C0NSTANT_Utf8_info (String s) { 
tag & 1; 

length =■ s. length (); 
bytes « s; 

) 

/** Used during input serialization by ClassFile only. */ 
public CONSTANT_Utf8_info (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

if (tag != 1) 

throw new ClassFormatError () ; 

length = in. readChar () ; 

byte[] b = new byte [length] ; 

in. read (b, 0, length); 

// WARNING: String constructor is deprecated, 
bytes - new String (b, 0, length); 

) 

/** Used during output serialization by ClassFile only. V 
public void serialize (DataOutputStream out) 
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throws IOException{ 
out. writeByte (tag) ; 
out. writeChar (length) ; 

// WARNING: Handling of String coversion here might be problematic, 
out . writeBytes (bytes ) ; 

) 

public String toString(){ 
return bytes; 

} 



} 

A26. ConstantVaIue_attribute.java 

Convience class for representing ConstantValue_attribute structures within 
ClassFiles. 

import j ava . lang . * ; 
import java.io.*; 

/** Attribute that allows for initialization of static variables in 

* classes. This attribute will only reside in a field_info struct. 
*/ 

public final class ConstantValue_attribute extends attribute_info{ 
public int constantvalue_index; 

public ConstantValue_attribute (ClassFile cf, int ani, int al, int cvi) { 
super (cf ) ; 

attribute^ ame_index = ani; 
attribute_length = al; 
constantvalue_index = cvi; 

} 

public ConstantValue_attribute (ClassFile cf, DatalnputStream in) 
throws IOException{ 
super (cf, in); 

constantvalue_index = in . readChar ( ) ; 

} 

public void serialize (DataOutputStream out) 
throws IOException{ 
attribute_length =2; 
super. serialize (out) ; 
out .writeChar (constantvalue_index) ; 

} 

} 

All. cp_info.java 

Convience class for representing cpjnfo structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Represents the common interface of all constant pool parts 

* that all specific constant pool items must inherit from. 

*/ 
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public abstract class cp_info{ 

/** The type tag that signifies what kind of constant pool 

* item it is */ 
public int tag; 

/** Used for serialization of the object back into a bytestream. •*/ 
abstract void serialize (DataOutputStream out) throws IOException; 

/** Default constructor. Simply does nothing. */ 
public cp_info() {) 

/** Constructor simply takes in the ClassFile as a reference to 

* it's parent 
*/ 

public cp_info (ClassFile cf) {} 

/** Dsed during input serialization by ClassFile only. */ 
cp_info (ClassFile cf, DatalnputStream in) 

throws IOException { 

tag = in.readUnsignedByteO ; 

} 



} 

A28. Deprecated_attribute.java 

Convience class for representing Deprecated_attribute structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** A fix attributed that can be located either in the ClassFile, 

* field_info or the method_info attribute. Mark deprecated to 

* indicate that the method, class or field has been superceded. 
*/ 

public final class Deprecated_attribute extends attribute_info{ 

public Deprecated_attribute (ClassFile cf, int ani, int al) { 
super (cf) ; 

attribute_name_index ■ ani; 
attribute_length » al; 

) 

/** Used during input serialization by ClassFile only. */ 
Deprecated^attribute (ClassFile cf, DatalnputStream in) 

throws IOException { 

super (cf, in); 

} 

} 

A29. Exceptions_attribute.java 

Convience class for representing Exceptions_attribute structures within ClassFiles. 



import java.lang.*; 
import j ava . io . * ; 

/** This is the struct where the exceptions table are located. 

* <br><br> 

* This attribute can only appear once in a method_info struct. 
*/ 

public final class Exceptions_attribute extends attribute_info{ 
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public int number_of_exceptions; 
public int[] exception_index_table; 

public Exceptions_attribute (ClassFile cf, int ani, int al, int noe, 

int[] eit){ 

super (cf) ; 

attribute_narae_index = ani; 
attribute_length = al; 
number_of_exceptions = noe; 
exception_index_table = eit; 

} 

/** Used during input , serialization by ClassFile only. */ 
Exceptions_attribute {ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in) ; 

number_of_exceptions = in.readChar () ; 
exception_index_table » new int [number_of_exceptions] ; 
for (int i=0; i<nuraber_of_exceptions; i++) 

exception_index_table[i] = in. readChar ( ) ; 

} 

/** Used during output serialization by ClassFile only. */ 
public void serialize (DataOutputStream out) 
throws IOException{ 

attribute_length - 2 + (nuraber_of_exceptions*2) ; 
super . serialize (out) ; 
out .writeChar ( numb er_of_except ions) ; 
for (int i»0; i<number_of_exceptions; i++) 
out. writeChar (exception_index_table [i] ) ; 

) 



A30. field_info.java 

Convience class for representing fieldjnfo structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** Represents the field_info structure as specified in the JVM 
specification. 
*/ 

public final class field_info{ 

public int access_f lags; 
public int name_index; 
public int descriptor_index; 
public . int attributes_count; 
public attribute_info[] attributes; 

/** Convenience constructor. */ 

public field_info (ClassFile cf, int flags, int ni, int di) { 
access_flags =» flags; 
name_index = ni; 
descriptor_index = di; 
attributes_count = 0; 
attributes = new attribute_info[0] ; 

} 

/** Constructor called only during the serialization process. 

* <br><br> 

* This is intentionally left as package protected as we 

* should not normally call this constructor directly. 
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* <brxbr> . 

* Warning: the handling of len is not correct (after String s =...) 

*/ 

field_info(ClassFile cf, DatalnputStream in) 
throws IOExceptionf 
access_flags = in. readChar ( ) ; 
name_index » in . readChar ( ) ; 
descriptor_index = in . readChar () ; 
attributes_count « in. readChar () ; 
attributes « new attribute_info[attributes_count] ; 
for (int i=0; i<attributes_count; i++) { 
in.mark(2); 

String s « cf .constantjpool [ in. readChar ()] .toSt ring () ; 
in. reset () ; 

if ( s. equals ("ConstantValue") ) 

attributes [i] « new ConstantValue_attribute (cf , in); 
else if (s. equals ("Synthetic") ) 

attributes [i] « new Synthetic_attribute (cf , in); 
else if (s. equals ("Deprecated") ) 

attributes [i] = new Deprecated_attribute (cf , in); 

else . 

attributes [i] - new attributeJLnfo . Unknown (cf, in); 

) 

) 

/** To- serialize the contents into the output format. 
*/ 

public void serialize (DataOutputStream out) 
throws IOException{ 
out . wri teChar ( access_f lags ) ; 
out.writeChar (name_index) ; 
out . writeChar (descriptor_index) ; 
out . writeChar ( att ributes_count ) ; 
for (int i=0; i<attributes_count; i++) 
attributes [i] . serialize (out) ; 

) 



A3L InnerClasses_attribute.java 

Convience class for representing InnerClasses_attribute structures within ClassFiles. 



import java.lang.*; 
import java.io.*; 

/** A variable length structure that contains information about a 
* inner class of this class. 

public final class InnerClasses_attribute extends attribute_inf o { 

public int number_of_classes; 
public classes [] classes; 

public final static class classes { 
int inner_class_ info_index; 
int outer_class_info_index; 
int inner_narae_index; 
int inner_class_access_flags; 

) 

public lnnerClasses_attribute(ClassFile cf, int ani, int al, 

int noc, classes [] c) { 

super (cf); 

attribute_name_index - ani; 
attributeJLength = al; 
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number_of_classes => noc; 
classes = c; 

) 

/** Used during input serialization by ClassFile only. */ 
InnerClasses_attribute (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in); 

number_of_classes = in. readChar () ; 

classes = new lnnerClasses_attribute. classes [number_of_classes] ; 
for (int i=0; i<number_of_classes; i++) { 
classes [i] « new classes (); 

classes [i] ,inner_class_info_index = in. readChar () ; 
classes [i] ,outer_class_info_index = in. readChar () ; 
classes [i] ,inner_name_index = in. readChar () ; 
classes [i] .inner_class_access_f lags = in. readChar () ; 

} 

) 

/** Used during output serialization by ClassFile only. */ 
public void serialize (DataOutputStream out) 
throws IOException{ 

attribute^ ength - 2 + (number_of_classes * 8) ; 

super. serialize (out) ; 

out. writeChar (number_of_ classes) ; 

for (int i=0; i<number_of_classes; i++) ( 

out. writeChar (classes [i] . inner_class_info_index) ; 

out. writeChar (classes [i] . outer_class_info_index) ; 

out. writeChar (classes [i] . inner_name_index) ; 

out. writeChar (classes [i] . inner_class_access_f lags) ; 

} 

} 



A32. LineNumberTable_attribute.java 

Convience class for representing LineNumberTable_attribute structures within 
ClassFiles. 



import java.lang.*; 
import java.io.*; 

/** Determines which line of the binary code relates to the 
* corresponding source code. 
*/ 

public final class LineNumberTable_attribute extends attribute_info{ 

public int line_number_table_length; 

public line_number_table[] 1 inejnumbe ratable; 

public final static class linejnumber_table{ 
int startjpc; 
int line_number; 

) 

public LineNumberTable_attribute (ClassFile cf, int ani, int al, int 

lnt1 ' line_number_table [] Int) { 

super (cf) ; 

attribute_narae_index =» ani; 
attributeJLength » al; 
line_ number_table_length » lntl; 
line number_table = lnt; 



56 



WO 2005/103927 



PCT/AU2005/000581 



) 

/** Used during input serialization by ClassFile only. */ 
LineNumberTable_attribute (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in) ; 

line_number_table_length = in. readChar () ; 
line_numberj:able - new 
LineNumberTable_attribute . line_number_table [line_number_table_lengtn] ; 
for (int i=0; i<line_number_table_length; i++) { 

line_number_table[i] = new 1 ine_numbe ratable () ; 

line_number_table(i] .start_pc - in. readChar () ; 

line_number_table(i] .line_number = in. readChar () ; 

) 

) 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 
throws IOException{ 

attribute_length « 2 + (line_number_table_length * 4); 
super. serialize (out) ; 

out .writeChar (line__number_table_length) ; 

for (int i=0; i<line_number_table_length; i++) { 

out. writeChar (line_number_table [i] ,start_pc) ; 

out. writeChar (line_number_table [i] .line_number) ; 

} 

} 



A33 . LocalVariabIeTable_attribute.java 

Convience class for representing LocalVariableTable_attribute structures within 
ClassFiles. 



import java.lang.*; 
import java.io.*; 

/** Used by debugger to find out how the source file line number is linked 

* to the binary code. It has many to one correspondence and is found in 

* the Code_attribute . 

* / 

public final class LocalVariableTable_attribute extends attribute_info{ 

public int local_variable_table_length; 

public local_variable_table[] local_variableJ:able; 

public final static class local_variable_table{ 
int start_pc; 
int length; 
int name_index; 
int descriptor_index; 
int index; 

) 



public LocalVariableTable attribute (ClassFile cf, int ani, int al, 
* ~ int lvtl, local_variable_table[] 



lvt){ 



super (cf) ; 

attribute_name_index » ani; 
attribute_length » al; 
local_yariable_table_length « lvtl; 
local_variable_table - lvt; 



57 



WO 2005/103927 



PCT/AU2005/000581 



/** Used during input serialization by ClassFile only. */ 
LocalVariableTable_attribute (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in) ; 

local_variable_table_length - in. readChar () ; 

local variable_table » new , ^, ^ i 

LocalVariableTable_attribute . local_variable_table [local_variable_table _lengt 

h] ; 

for (int i«0; i<local_variable_table_length; i++) { 

local_variable_table[i] = new 1 ocal_vari able_t able () ; 
local_variable_table[i] .start_pc « in. readChar () ; 
local_variable_table[i] .length = in. readChar () ; 
local_variable_table[i] .narae_index = in. readChar () ; 
local_variable_table[i] . descriptor_index » in. readChar () ; 
local_variable_table[i] .index = in. readChar () ; 

} 

} 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 
throws IOException{ 

attribute_length - 2 + (local_variable_table_length * 10); 
super. serialize (out) ; 

out . writeChar (local_variableJ:able_length) ; 

for (int i=0; i<local_variable_table_length; i++) { 

out.writeChar (local_variable_table[i] .start_pc) ; 

out.writeChar (local_variable_table [i] .length) ; 

out.writeChar (local_variable_table [i] . name_index) ; 

out.writeChar (local_variable_table [i] . descriptor_index) ; 

out.writeChar (local_variable_table [i] .index) ; 

} 

} 



A34. method Jnfo.java 

Convience class for representing methodjnfo structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** This follows the method_info in the JVM specification. 
*/ 

public final class raethod_info { 

public int access_f lags; 
public int name_index; 
public int descriptor_index; 
public int attributes_count; 
public attribute_info[] attributes; 

/** Constructor. Creates a method_info f initializes it with 

* the flags set, and the name and descriptor indexes given. 

* A new uninitialized code attribute is also created, and stored 

* in the <i>code</i> variable.*/ 

public method_info (ClassFile cf, int flags, int ni, int di, 
int ac, attribute_info[] a) { 
access_flags » flags; 
name_index - ni; 
descriptorjLndex « di; 
attributes_count » ac; 
attributes » a; 

} 
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/** This method creates a method_info from the current pointer in the 

* data stream. Only called by during the serialization of a complete 

* ClassFile from a bytestream, not normally invoked directly. 
*/ 

method_info (ClassFile cf, DatalnputStream in) 
throws IOException{ 
access_flags = in . readChar () ; 
name_index = in. readChar () ; 
descriptor_index « in. readChar () ; 
attributes_count - in. readChar () ; 
attributes = new attribute_info [ attribute s_count ] ; 
for (int i=0; Kattributes^count; i++) { 
in. mark (2) ; 

String s = cf .constant j?ool[ in. readChar ()] .toString() ; 

in. reset () ; 

if (s. equals ("Code") ) 

attributes [i J - new Code_attribute (cf , in); 
else if (s. equals ("Exceptions") ) 

attributes [i] - new Exceptions_attribute (cf , in); 
else if (s. equals ("Synthetic") ) 

attributesfi] » new Synthetic_attribute (cf , in); 
else if (s .equals ("Deprecated") ) 

attributes [i] - new Deprecated_attribute (cf , in); 

else 

attributes[i] » new attribute_inf o. Unknown (cf, in); 

) 

) 

/** Output serialization of the method_info to a byte array. 

* Not normally invoked directly. 
*/ 

public void serialize (DataOutputStream out) 
throws IOException{ 
out .writeChar (access_f lags) ; 
out.writeChar (name_index) ; 
out . writeChar (descriptor_index) ; 
out . writeChar ( attr ibut es_count ) ; 
for (int i=0; i<attributes_count; i++) 
attributes [i] . serialize (out) ; 

} 

} 

A35. SourceFile_attribute.java 

Convience class for representing SourceFile_attribute structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** A SourceFile attribute is an optional fixed_length attribute in 

* the attributes table. Only located in the ClassFile struct only 

* once. 
V 

public final class SourceFile_attribute extends attribute_info{ 
public int sourcefile_index; 

public SourceFile_attribute (ClassFile cf, int ani, int al, int sfi) { 
super (cf) / 

attribute_name_index = ani; 
attribute_length = al; 
sourcefile_index = sfi; 

) 

/** Used during input serialization by ClassFile only. */ 
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SourceFile_attribute (ClassFile cf, DatalnputStream in) 
throws IOException{ 
super (cf, in); 

source file_index = in. readChar ( ) ; 

) 

/** Used during output serialization by ClassFile only. */ 
void serialize (DataOutputStream out) 

throws IOException{ 

attribute_length » 2; 

super. serialize (out) ; 

out .writeChar (sourcef ile_index) ; 

) 

} 

A36. Synthetic_attribute.java 

Convience class for representing Synthetic_attribute structures within ClassFiles. 

import java.lang.*; 
import java.io.*; 

/** A synthetic attribute indicates that this class does not have 

* a generated code source. It is likely to imply that the code 

* is generated by machine means rather than coded directly. This 

* attribute can appear in the classfile, method_info or field_info. 

* It is fixed length. 
*/ 

public final class Synthetic_attribute extends attribute_info{ 

public Synthetic_attribute (ClassFile cf, int ani, int al) { 
super (cf ) ; 

attribute_name_index ■ ani; 
attribute_length « al; 

) 

/** Used during output serialization by ClassFile only. */ 
Synthetic_attribute (ClassFile cf, DatalnputStream in) 

throws IOException{ 

super (cf, in) ; 

} 

} 

Annexure C 

CI . TYPICAL PRIOR ART FINALIZATION FOR A SINGLE MACHINE: 
Method finalizeO 

0 getstatic #9 <Field java.io.PrintStream out> 
3 ldc #24 <String "Deleted... '■> 

5 invokevirtual #16 <Method void println(java.lang.String)> 
8 return 

C2. PREFERRED FINALIZATION FOR MULTIPLE MACHINES 
Method finalizeO 

0 invokestatic #3 <Method boolean isLastReference()> 
3ifue7 

6 return 

7 getstatic #9 <Field java.io.PrintStream out> 
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10 ldc #24 <String "Deleted... M > 

12 invokevirtual #16 <Method void printlnGava.lang.String)> 

15 return 

C3. PREFERRED FINALIZATION FOR MULTIPLE MACHINES (Alternative) 

Method finalizeO 

0 aloadj) 

1 invokestatic #3 <Method boolean isLastReference(java.lang.Object)> 
4ifne8 

7 return 

8 getstatic #9 <Field java.io.PrintStream out> 

11 ldc #24 <String n Deleted..."> 

13 invokevirtual #16 <Method void printlnQava.lang.String)> 

16 return 

Annexure C4 

import java.lang.*; 
public class example { 

/** Finalize method. */ 

protected void finalize!) throws Throwable{ 

// "Deleted..." is printed out when this object is garbaged. 
System. out. println ("Deleted. . .") ; 



} 



} 

Annexure C5 

import java.lang.*; 
import java.util.*; 
import j ava . net . * ; 
import java.io.*; 

public class FinalClient{ 

/** Protocol specific values. */ 

public final static int CLOSE = -1; 

public final static int NACK - 0/ 

public final static int ACK - 1; 

public final static int FINAL I ZE_OB JECT = 10/ 

/** FinalServer network values. */ 

public final static String serverAddress = 
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System, get Property ("FinalServer_network_address") ; 
public final static int serverPort = 

Integer. parselnt (System. getProperty ("FinalServer_network_port") ) ; 

/** Table of global ID's for local objects. (hashcode-to-globallD 
mappings) */ 

public final static Hashtable hashCodeToGloballD = new Hashtable (); 

/** Called when a object is being finalized. */ 
public static boolean isLastReference (Object o) { 

// First of all, we need to resolve the globallD for object 'o'. 

// To do this we use the hashCodeToGloballD table. 

int globallD » ((Integer) hashCodeToGloballD. get <o) ). intValue {) ; 

try( 

// Next, we want to connect to the FinalServer, which will inform 
// us of the finalization status of this object. 
Socket socket = new Socket (server Address, serverPort); 
DataOutputStream out « 

new DataOutputStream { socket. getOutputSt ream () ) ; 
DatalnputStream in « new DataInputStream( socket .getlnputStreamO ) ; 

// Ok, now send the serialized request to the FinalServer. 
out .writelnt (FINAI»IZE_OBJECT) ; 
out .writelnt (globallD) ; 
out. flush () ; 

// Now wait for the reply. 

int status = in.readlnt () ; // This is a blocking call. So we 

// will wait until the remote side 
// sends something. 

if (status — NACK) { 

throw new AssertionError ( 

"Negative acknowledgement. Request failed."); 
}else if (status !- ACK) { 

throw new AssertionError ("Unknown acknowledgement: " 
+ status + " . Request failed."); 

) 

// Next, read in a 32bit argument which is the count of the 
// remaining f inalizations 
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int count = in. readlnt ( ) ; 

// If the count is equal to 1, then this is the last finalization, 
// and hence isLastReference should be true. 

// If however, the count is greater than 1, then this is not the 
// last finalization, and thus isLastReference should be false, 
boolean isLastReference - (count — 1 ? true : false) ; 

// Close down the connection, 
out. writelnt (CLOSE) ; 
out . flush ( ) ; 
out. close ( ) ; 
in. close () ; 

socket. close () ; // Make sure to close the socket. 

// Return the value of the isLastReference variable, 
return isLastReference; 

}catch (IOException e) { 

throw new AssertionError ("Exception : " + e. toString () ) ; 

) 

} 

) 

Annexure C6 

import java.lang.*; 
import java.util.*; 
import java.net.*; 
import java.io.*; 

public class FinalServer implements Runnable{ 

/** Protocol specific values */ 

public final static int CLOSE » -1; 

public final static int NACK » 0; 

public final static int ACK = 1; 

public final static int FINALIZE_OBJECT - 10; 

/** FinalServer network values. */ 

public final static int serverPort * 20001; 

/** Table of finalization records. */ 

public final static Hashtable finalizations = new HashtableO; 



63 



WO 2005/103927 



PCT/AU2005/000581 



/** Private input/output objects. */ 
private Socket socket = null; 
private DataOutputStream outputStream; 
private DatalnputStream input St ream; 
private String address; 

public static void main (String [] s) 
throws Exception { 

System . out . println ( " Final Server_network_addres s=" 

+ InetAddress . getLocalHost < ) . getHostAddress ( ) ) ; 
System. out. println ( H FinalServer_network_port= n + serve r Port ) ; 

// Create a serversocket to accept incoming initialization operation 
// connections. 

ServerSocket serverSocket = new ServerSocket (serverPort) ; 
while (! Thread. interrupted () ) { 

// Block until an incoming initialization operation connection. 
Socket socket =» serverSocket . accept () ; 

// Create a new instance of InitServer to manage this 

// initialization operation connection. 

new Thread(new FinalServer (socket) ) .start () ; 

} 

} 

/** Constructor. Initialize this new FinalServer instance with necessary 

resources for operation. */ 
public FinalServer (Socket s) { 

socket = s; 

try{ 

outputStream - new DataOutputStream (s .getOutputStrearo( )) ; 
inputStream ■* new DatalnputStream (s .getlnputStreamO ) ; 
address - s .get InetAddress () .getHostAddress () ; 
} catch (IOException e) { 

throw new Ass ertionError ("Exception: " + e . toString ( ) ) ; 

} 

} 

/** Main code body. Decode incoming finalization operation requests and 
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execute accordingly. */ 
public void run() { 

try{ 

// All commands are implemented as 32bit integers. 

// Legal commands are listed in the "protocol specific values" 

// fields above. 

int command = inputSt ream. readlnt {) ; 

// Continue processing commands until a CLOSE operation, 
while (command != CLOSE) { 

if (command FINALIZE_OBJECT) { // This is a 

// FINALI ZE_OB JECT 
// operation. 

// Read in the globallD of the object to be finalized, 
int globallD » inputStream. readlnt () ; 

// Synchronize on the f inalizations table in order to ensure 
// thread-safety, 
synchronized ( f inalizations ) { 

// Locate the previous finalizations entry for this 
// object, if any. 

Integer entry = (Integer) finalizations . get ( 
new Integer (globallD) ) ; 

if (entry — null) { 

throw new AssertionError ( "Unknown object."); 
Jelse if (entry. intValueO < 1) { 

throw new AssertionError ( "Invalid count."); 
Jelse if (entry. intValueO — 1) { // Count of 1 means 

// this is the last 
// reference, hence 
// remove from table. 

finalizations . remove (new Integer (globallD) ) ; 

// Send a positive acknowledgement to FinalClient, 
// together with the count of remaining references - 
// which in this case is 1. 
outputStream.wri telnt (ACK) ; 



65 



WO 2005/103927 



PCT/AU2005/000581 



outputStream.writelnt (1) ; 
output Stream. flush ( ) ; 

}else{ // This is not the last remaining 

// reference, as count is greater than 1. 
// Decrement count by 1. 

finalizations.put (new Integer (globallD) / 
new Integer (entry. intValueO - 1)); 

// Send a positive acknowledgement to FinalClient, 
// together with the count of remaining references to 
// this object - which in this case of must be value 
// "entry.intValueO". 
outputStream.writelnt (ACK) ; 
outputStream.writelnt (entry.intValueO ) ; 
outputStream. flush ( ) ; 

} 

} 

}else{ // Unknown command, 

throw new AssertionError ( 

"Unknown command. Operation failed."); 

} 

// Read in the next command, 
command » inputs t ream. readlnt () ; 



}catch (Exception e) { 

throw new AssertionError ( "Exception: " + e. toString ( ) ) ; 

} finally { 
try{ 

// Closing down. Cleanup this connection. 
outputStream . flush ( ) / 
outputStream. close () ; 
inputStream. close () ; 
socket. close () ; 
} catch (Throwable t) { 
t . printStackTrace ( ) ; 



66 



WO 2005/103927 



PCT/AU2005/000581 



// Garbage these references, 
outputs t ream = null; 
inputStream « null; 
socket « null; 

} 

) 



ANNEXUREC7 

FinalLoader.java 

This excerpt is the source-code of FinalLoader, which modifies an application as it is 
being loaded. 

import java.lang.*; 
import java.io.*; 
import java.net.*; 

public class FinalLoader extends URLClass Loader { 

public FinalLoader (URL [] urls) { 
super (urls) ; 

} 

protected Class findClass (String name) 
throws ClassNotFoundException{ 

ClassFile cf « null; 

try{ 

BufferedlnputStream in = 

new BufferedlnputStream (findResource (name, replace (' . ' , 
•/•) .concat class" ) ) .openStream( ) ) ; 

cf = new ClassFile (in) ; 
}catch (Exception e) {throw new ClassNotFoundException (e.toString () ) ; } 



for (int i«=0; i<cf .methods_count; i++) { 

// Find the finalize methodjlnfo struct. 
String methodName = cf . constant_pool [ 

cf. methods [i] .name_index] .toStringO ; 
if ( ImethodName. equals ("finalize") ) { 

continue; 

} 

// Now find the Code_attribute for the finalize method, 
for (int j=0; j<cf .methods [i] .attributes_count; j++) { 

if (! (cf. methods [i] .attributes [j] instanceof Code_attribute) ) 
continue; 

Code_at tribute ca = (Code_attribute) 
cf .methods [i] . attributes [ j J ; 

// First, shift the code[] down by 4 instructions. 
byte[][] code2 = new byte lea. code. length+4] [] ; 
System. arraycopy (ca . code, 0, code2, 4, ca . code. length) ; 
ca.code = code2; 
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// Then enlarge the constant_pool by 6 items. 
cp_info[] cpi = new cp_info[cf . constant_pool .length+6] ; 
System. arraycopy (cf . constantjpool, 0, cpi, 0/ 

cf .constantjpool. length) / 
cf .constantjpool = cpi; 
cf .constant^j>ool_count += 6; 

// Now add the DTF for class. 

CONSTANT_Utf8_info ul «= new CONSTANTJJtf 8_info ( "FinalClient") ; 
cf. constantjpool [cf .constantjpool. length-6] « ul; 

// Now add the CLASS for the previous UTF. 
CONSTANT_Class_info cl « 

new CONSTANTj:iass_info(cf. constantjpool. length-6) ; 
cf .constant jPOol[cf. constant jPool.length-5] = cl; 

// Next add the first UTF for NameAndType. 

ul = new CONSTANT jUtf 8 jinfo("isLastReference n ) ; 

cf .constantjpool [cf .constantjpool. length- 4] = ul; 

// Next add the second UTF for NameAndType. 

ul - new CONSTANT_Utf8_info(" (Ljava/lang/Object; ) Z") ; 

cf ,constant_pool[cf . constantjpool . length-3] « ul; 

// Next add the NameAndType for the previous two UTFs. 
CONSTANT_NameAndType_info nl = new CONSTANT_NameAndType_inf o ( 

cf . constantjpool . length-4 , cf . constant_pool . length-3) ; 
cf. constantjpool [cf .constantjpool. length-2] = nl; 

// Next add the Methodref for the previous CLASS and 

NameAndType . 

CONSTANT ^Methodref jinfo ml « new CONSTANT_Methodref _inf o ( 
cf . cons tantjpool , length-5, cf . constantjpool . length-2 ) ; 
cf .constantjpool [cf. constant j>ool.length-l] » ml; 

// Now with that done, add the instructions into the code, 

starting 

// with LDC. 

ca.code[0] = new byte[l]; 
ca.code[0] [0] = (byte) 42; 

// Now Add the INVOKESTATIC instruction. 
ca.code[l] « new byte [3]; 
ca.code[l] [0] = (byte) 184; 

ca.code[l] [1] « (byte) (( (cf. constantjpool .length-1) » 8) & 

Oxf f ) ; 

ca.code[l] [2] « (byte) ( (cf . constant_pool . length-1) & Oxf f ) ; 

// Next add the IFNE instruction. 

ca.code[2] « new byte[3]; 

ca.code[2) [0] = (byte) 154; 

ca.code[2] [1] = (byte) ((4 » 8) & Oxf f ) ; 

ca.code[2] [2] - (byte) (4 & Oxf f ) ; 

// Finally, add the RETURN instruction. 
ca.code[3] = new byte[l); 
ca.code[3] [0] « (byte) 177; 

// Lastly, increment the CODE_LENGTH and ATTRIBUTE_LENGTH 

values . 

ca.code_length +« 8; 
ca.attribute_length += 8; 
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try{ 

ByteArrayOutputStream out = new ByteArrayOutputStrearaO ; 
cf . serialize (out) ; 

byte [ ] b = out . toByteArray ( ) ; 

return def ineClass (name, b, 0, b. length); 

) catch (Exception e) { 
e .printStackTrace ( ) ; 

throw new ClassNotFoundException (name) ; 

} 

) 

) 
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CLAIMS 

1 . A multiple computer system having at least one application program running 
simultaneously on a plurality of computers interconnected by a 
communications network, wherein a like plurality of substantially identical 
objects are created, each in the corresponding computer and each having a 
substantially identical name, and wherein all said identical objects are 
collectively deleted when each one of said plurality of computers no longer 
needs to refer to their corresponding object 

2. The system as claimed in claim 1 wherein each said computer includes a 
distributed run time means with the distributed run time means of each said 
computer able to communicate with all other computers whereby if a portion 
of said application program(s) running on one of said computers no longer 
needs to refer to an object in that computer then the identity of the 
unreferenced object is transmitted by the distributed run time means of said 
one computer to a shared table accessible by all the other computers. 

3. The system as claimed in claim 2 wherein each said application program is 
modified before, during, or after loading by inserting a finalization routine to 
modify each instance at which said application program no longer needs to 
refer to an object. 

4. The system as claimed in claim 3 wherein the application program is 
modified in accordance with a procedure selected from the group of 
procedures consisting of re-compilation at loading, pre-compilation prior to 
loading, compilation prior to loading, just-in-time compilation, and re- 
compilation after loading and before execution of the relevant portion of 
application program. 

5. The system as claimed in claim 2 wherein said modified application program 
is transferred to all said computers in accordance with a procedure selected 
from the group consisting of master/slave transfer, branched transfer and 
cascaded transfer. 
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6. A plurality of computers interconnected via a communications link and 
operating at least one application program simultaneously wherein each said 
computer in operating said at least one application program needs, or no 
longer needs to refer to an object only in local memory physically located in 
each said computer, the contents of the local memory utilized by each said 
computer is fundamentally similar but not, at each instant, identical, and 
every one of said computers has a finalization routine which deletes a non- 
referenced object only if each one of said plurality of computers no longer 
needs to refer to their corresponding object 

7. The plurality of computers as claimed in claim 6 wherein the local memory 
capacity allocated to the or each said application program is substantially 
identical and the total memory capacity available to the or each said 
application program is said allocated memory capacity. 

8. The plurality of computers as claimed in claim 6 wherein all said distribution 
update means communicate via said communications link at a data transfer 
rate which is substantially less than the local memory read rate. 

9. The plurality of computers as claimed in claim 6 wherein at least some of 
said computers are manufactured by different manufacturers and/or have 
different operating systems. 

10. A method of running at least one application program on a plurality of 
computers simultaneously, said computers being interconnected by means of 
a communications network, said method comprising the steps of: 

(i) creating a like plurality of substantially identical objects each in the 
corresponding computer and each having a substantially identical name, and 

(ii) deleting all said identical objects collectively when all of said plurality 
of computers no longer need to refer to their corresponding object. 

1 1 . A method as claimed in claim 10 including the further step of: 

(iii) providing each said computer with a distributed run time means to 
communicate between said computers via said communications network. 
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12. A method as claimed in claim 1 1 including the further step of: 

(iv) providing a shared table accessible by each said distributed run time 
means and in which is stored the identity of any computer which no longer 
requires to access an object, together with the identity of the object. 

13. A method as claimed in claim 12 including the further step of: 

(v) associating a counter means with said shared table, said counter means 
storing a count of the number of said computers which no longer require to 
access said object. 

14. A method as claimed in claim 13 including the further step of: 

(vi) providing an additional computer on which said shared program does 
not run and which hosts said shared table and counter, said additional 
computer being connected to said communications network. 

15. A method of ensuring consistent finalization of an application program to be 
run simultaneously on a plurality of computers interconnected via a 
communications network, said method comprising the steps of: 

(i) scrutinizing said application program at, or prior to, or after loading to 
detect each program step defining an finalization routine, and 

(ii) modifying said finalization routine to ensure collective deletion of 
corresponding objects in all said computers only when each one of said 
computers no longer needs to refer to their corresponding object. 

16. The method claimed in claim 15 wherein step (ii) comprises the steps of: 

(iii) loading and executing said finalization routine on one of said 
computers, 

(iv) modifying said finalization routine by said one computer, and 

(v) transferring said modified finalization routine to each of the remaining 
computers. 

17. The method as claimed in claim 16 wherein said modified finalization 
routine is supplied by said one computer direct to each of said remaining 
computers. 

1 8. The method as claimed in claim 16 wherein said modified finalization 
routine is supplied in cascade fashion from said one computer sequentially to 
each of said remaining computers. 
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19. The method claimed in claim 15 wherein step (ii) comprises the steps of: 

(vi) loading and modifying said finalization routine on one of said 
computers, 

(vii) said one computer sending said unmodified finalization routine to each 
of the remaining computers, and 

(viii) each of said remaining computers modifying said finalization routine 
after receipt of same. 

20. The method claimed in claim 19 wherein said unmodified finalization 
routine is supplied by said one computer directly to each of said remaining 
computers. 

21. The method claimed in claim 19 wherein said unmodified finalization 
routine is supplied in cascade fashion from said one computer sequentially to 
each of said remaining computers. 

22. The method as claimed in claim 15 including the further step of: 

(ix) modifying said application program utilizing a procedure selected from 
the group of procedures consisting of re-compilation at loading, pre- 
compilation prior to loading, compilation prior to loading, just-in-time 
compilation, and re-compilation after loading and before execution of the 
relevant portion of application program. 

23. The method as claimed in claim 15 including the further step of: 

(x) transferring the modified application program to all said computers 
utilizing a procedure selected from the group consisting of master/slave 
transfer, branched transfer and cascaded transfer. 

24. In a multiple thread processing computer operation in which individual 
threads of a single application program are simultaneously being processed 
each on a corresponding one of a plurality of computers interconnected via a 
communications link, and in which objects in local memory physically 
associated with the computer processing each thread have corresponding 
objects in the local memory of each other said computer, the improvement 
comprising collectively deleting all said corresponding objects when each 
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one of said plurality of computers no longer needs to refer to their 
corresponding object. 

25. The improvement as claimed in claim 24 wherein an object residing in the 
memory associated with one said thread and to be deleted has its identity 
communicated by the computer of said one thread to a shared table 
accessable by all other said computers. 

26. The improvement as claimed in claim 24 wherein an object residing in the 
memory associated with one said thread and to be deleted has its identity 
transmitted to the computer associated with another said thread and is 
transmitted thereby to a shared table accessable by all said other computers. 

27. A computer program product comprising a set of program instructions stored 
in a storage medium and operable to permit a plurality of computers to carry 
out the method as claimed in claim 10 or 15. 

28. A plurality of computers interconnected via a communication network and 
operable to ensure consistent initialization of an application program running 
simultaneously of said computers, said computers being programmed to 
carry out the method as claimed in claim 10 or 15 or being loaded with the 
computer program product as claimed in claim 26. 



74 



v 



WO 2005/103927 



PCT/AU2005/000581 




FIG. 1 



MEMORY 




7 




\*3 





PRIOR ART 





GLOBAL MEMORY 



FIG. 2 

PRIOR ART 







FIG. 3 

PRIOR ART 



WO 2005/103927 



PCT/AU2005/000581 



2/14 




FIG. 4 

PRIOR ART 




WO 2005/103927 



PCT/AU2005/000581 



3/14 




WO 2005/103927 



PCT/AU2005/000581 



4/14 




CREATE A LIST OF ALL MEMORY LOCATIONS 
(ie. CLASSES & OBJECT FIELDS IN THE 
JAVA LANGUAGE) 




SEARCH THROUGH THE EXECUTABLE CODE TO 
DETECT WRITING TO ANY OF THE LISTED 
MEMORY LOCATION(S) 

X 



92 



INSERT THE "UPDATING PROROGATION ROUTINE" 

TO (i) PROPOGATE THE IDENTITY OF LISTED 
MEMORY LOCATION(S) TO ALL OTHER MACHINES, 

AND (ii) UPDATE ANY CHANGED VALUE OF 
ANY LISTED MEMORY LOCATION TO ALL OTHER 

MACHINES 



1 


r 


CONTINUE LOADING PROCEDURE 



93 



FIG. 9 



94 



WO 2005/103927 



PCT/AU2005/000581 



5/14 



START LOADING PROCEDURE 



90 



CREATE A LIST OF ALU 
(ie. CLASSES & OBJE 
JAVA LAN* 


MEMORY LOCATIONS 
:CT FIELDS IN THE 
GUAGE) 






SEARCH THROUGH THE EXECUTABLE CODE TO 
DETECT WRITING TO ANY OF THE LISTED 
MEMORY LOCATION(S) 

\ 


i 





INSERT THE "ALERT ROUTINE" TO REQUEST 
THE THREAD(S) OF THE DRT TO 

(i) PROPOGATE THE IDENTITY OF LISTED MEMORY 
LOCATION(S) TO ALL OTHER MACHINES, AND 

(ii) UPDATE ANY CHANGED VALUE OF ANY 
LISTED MEMORY LOCATION TO ALL OTHER 

MACHINES 



1 


X 1 


CONTINUE LOADING PROCEDURE 



103 



FIG. 10 



94 



WO 2005/103927 



PCT/AU2005/000581 



6/14 




CD 
EC 



WO 2005/103927 



PCT/AU2005/000581 



7/14 




WO 2005/103927 



PCT/AU2005/000581 



8/14 





WO 2005/103927 



PCT/AU2005/000581 



9/14 



50Z 



50Y 



50 < 



OBJECT #3 \ 


DISTRIBUTED 
RUN 
TIME 


OBJECT #2 J 


OBJECT #1 


CLASS #1 - 


\ JAVA VIRTUAL MACHINE ) ^ 



71 



50X- 



50A 



V 



72 



FIG. 14 

PRIOR ART 



WO 2005/103927 



PCT/AU2005/000581 



10/14 







Mn 







<X+1 



FIG. 15 



START LOADING PROCEDURE 



DETECT ALL CLEAN-UP ROUTINES 
(ie. finalize () in the JAVA language) 



•161 



162 



163 



INSERT AN 'ENABLE/DISABLE" ROUTINE 
TO MODIFY EACH DETECTED 
CLEAN-UP ROUTINE 



164 



CONTINUE LOADING PROCEDURE 



FIG. 16 



WO 2005/103927 



11/14 



PCT/AU2005/000581 



■171 



COMMENCE "ENABLE/DISABLE" ROUTINE 







172 



LOOK UP THE GLOBAL "NAME" FOR THE STRUCTURE, 
ASSET OR RESOURCE TO BE CLEANED-UP 



DETERMINE THE CLEAN-UP STATUS OF 
THE STRUCTURE, ASSET OR RESOURCE TO BE 

CLEANED-UP 



•174 



-173 



IS 

GLOBAL 
"NAME" STILL 

UTILIZED 
ELSEWHERE 
? 



^175 



YES 


ABORT THE 


CLEAN-UP 


t ► 


ROUTINE 



CONTINUE THE 
CLEAN-UP 
ROUTINE 



■176 



FIG. 17 



WO 2005/103927 . 



12/14 



PCT/AU2005/000581 



SEND AN ENQUIRY TO MACHINE X 
TO ADVISE THE CLEAN-UP STATUS 
OF THE STRUCTURE, ASSET OR 
RESOURCE TO BE CLEANED-UP 





1 




AWAIT A REPLY FROM MACHINE X 
AS TO REQUESTED CLEAN-UP STATUS 
— ^ 



^-^■182 

FIG. 18 



WO 2005/103927 



PCT/AU2005/000581 



13/14 



RECEIVE A CLEAN-UP STATUS REQUEST 



191 



CONSULT A CLEAN-UP COUNTER TO DETERMINE 
IF THE STRUCTURE, ASSET OR RESOURCE WITH 
REQUESTED GLOBAL "NAME" IS MARKED FOR 
DELETION ON (N-1) MACHINES 




SEND A RESPONSE TO 
REPLY TO REQUEST & 
ADVISE GLOBAL "NAME" 
MARKED FOR DELETION 
ON (N-1) MACHINES 



UPDATE TABLE ENTRY 
FOR GLOBAL "NAME" 
IN THE SHARED TABLE 
TO HAVE STATUS 
"CLEANED-UP" 



192 



SEND A RESPONSE 
TO REPLY TO 

REQUEST & ADVISE 
GLOBAL "NAME" 
IS NOT MARKED 

FOR DELETION ON 
(N-1) MACHINES 



INCREMENT 
"MARKED FOR 
DELETION" 
COUNTER BY 
ONE (1) 



196 



197 



FIG. 19 



WO 2005/103927 



PCT/AU2005/000581 



14/14 





a 




314 ? 



116 




107 



FIG. 20 



101- 





'/mm , 




.102 





FIG. 21 



101 




108 



310 



lis 




FIG. 22 



INTERNATIONAL SEARCH REPORT 



International application No. 
PCT/AU2005/000581 



A. CLASSIFICATION OF SUBJECT MATTER 

IntCL 7 - G06F 15/16 

According to International Patent Classification (IPC) or to both national classification and IPC 



B. 



FIELDS SEARCHED 



Minimum documentation searched (classification system followed by classification symbols) 



Documentation searched other than minimum documentation to the extent that such documents are included in the fields searched 



Electronic data base consulted during the international search (name of data base and, where practicable, search terms used) 

DWPI, USPTO, PCT, IEEE, internet (object, replicate, redundant, mirror, cluster, distributed, lock, thread, compile, 

high availability, runtime, virtual machine, etc.) 



C. 



DOCUMENTS CONSIDERED TO BE RELEVXNT 



Category* 



Citation of document, with indication, where appropriate, of die relevant passages 



Relevant to 
claim No. 



X 



X 



WO 2003/083614 Al (ETERNAL SYSTEMS, INC.), 9 October 2003 
the whole document 



US 6,625,751 Bl (STAROVIC et al), 23 September 2003 
the whole document 



WO 2002/044835 A2 (GINGERICH), 6 June 2002 
the whole document 



US 2004/0073828 Al (BRONSTEIN), 15 April 2004 
the whole document 



1-28 



1-28 



1-28 



1-28 



Further documents are listed in the continuation of Box C 



See patent family annex 



* Special categories of cited documents: 
"A" document defining the general state of the art which is 
not considered to be of particular relevance 

"E" earlier application or patent but published on or after the 
international filing date 

document which may throw doubts on priority claim(s) 
or which is cited to establish the publication date of 
another citation or other special reason (as specified) 
M 0" document referring .to an oral disclosure, use, exhibition 
or other means 

"P" document published prior to the international filing date 
but later than the priority date claimed 



"X" 



later document published after the international filing date or priority date and not in 
conflict with the application but cited to understand the principle or theory 
underlying the invention 

document of particular relevance; the claimed invention cannot be considered novel 
or cannot be considered to involve an inventive step when the document is taken 
alone • 

document of particular relevance; the claimed invention cannot be considered to 
involve an inventive step when the document is combined with one or more other 
such documents, such combination being obvious to a person skilled in the art 



document member of the same patent family 



Date of the actual completion of the international search 
4 July 2005 



Date of mailing of the international search report 

M .JUL 2005 



Name and mailing address of the ISA/AU 

AUSTRALIAN PATENT OFFICE 
PO BOX 200, WODEN ACT 2606, AUSTRALIA 
E-mail address: pct@ipaustralia.gov.au 
■Facsimile No. (02) 6285 3929 



Authorized officer 

MATTHEW HOIXINGWORTH 

Telephone No : (02) 6283 2024 



Form PCT/ISA/2 1 0 (second sheet) (January 2004) 



INTERNATIONAL SEARCH REPORT 



International application No. 
PCT/AU2Q05/000581 



C (Continuation). DOCUMENTS CONSIDERED TO BE RELEVANT 



Category* 


Citation of document, with indication, where appropriate, of the relevant passages 


Relevant to 
claim No. 


X 
X 


US 5,488,723 A (BARADEL et al), 30 January 1996 
the whole document 

T. C. Bressoud, TFT: A Software System for Application-Transparent Fault Tolerance 
Proc. 28 th Annual International Symposium on Fault-Tolerant Computing, p. 128-37, 1998 


. 1-28 
1-28 



Form PCT/ISA/210 (continuation of second sheet) (January 2004) 



INTERNATIONAL SEARCH REPORT 


International application No. 


Information on patent family members 


PCT/AU2005/000581 



This Annex lists the known "A" publication level patent family members relating to the patent documents cited in the 
above-mentioned international search report. The Australian Patent Office is in no way liable for these particulars 
which are merely given for the purpose of information, . 



Patent Document Cited in 
Search Report 






Patent Family Member 


WO 03083614 


AU 


2003223352 


AU 2003230748 EP 1495414 




EP 


1495571 


US 2004078617 . US 2004078618 




WO 


03084116 




US 6625751 


GB 


2353113 




WO 0244835 


AU 


32411/02 




US . 2004073828. 


NONE 






US 5488723 


EP 


0572307 


FR 2691559 WO 9324884 


Due to data integration issues this family listing may not include 10 digit Australian applications filed since May 2001. 








END OF ANNEX 



Form PCT/ISA/2I0 (patent family annex) (January 2004) 



